Partners
Merchants
Onboard a merchant, request go-live, and manage settlement addresses.
Each tenant maps to one Orqpay merchant. There is no list endpoint — store merchantId when you create.
Create a merchant
Requires:
Authorization: Bearer orq_pk_test_…X-Request-Signature— pasteorq_ps_…in the playground (proxy signs)Idempotency-Key
curl -X POST "https://api.orqpay.com/v1/partner/merchants" \
-H "Authorization: Bearer orq_pk_test_..." \
-H "X-Request-Signature: t=...,v1=..." \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"externalTenantId": "your-tenant-id",
"email": "tenant@example.com",
"name": "Tenant Co"
}'Use externalTenantId as your stable id for that tenant in your product. Prefer the Request signer while integrating.
Go live
Register where paid funds should arrive (by networkId) and request review in one call.
See Networks for valid networkId values.
curl -X POST "https://api.orqpay.com/v1/partner/merchants/{merchantId}/go-live" \
-H "Authorization: Bearer orq_pk_test_..." \
-H "X-Request-Signature: t=...,v1=..." \
-H "Content-Type: application/json" \
-d '{
"settlementAddresses": [
{ "networkId": 137, "address": "0x…" }
],
"websiteUrl": "https://tenant.example"
}'Orqpay reviews and approves live access. Check status:
curl "https://api.orqpay.com/v1/partner/merchants/{merchantId}/go-live" \
-H "Authorization: Bearer orq_pk_test_..." \
-H "X-Request-Signature: t=...,v1=..."Or GET /v1/partner/merchants/{merchantId} and read integrationStatus:
test → pending_live → live
Settlement addresses
# Current wallets
curl "https://api.orqpay.com/v1/partner/merchants/{merchantId}/settlement-addresses" \
-H "Authorization: Bearer orq_pk_test_..." \
-H "X-Request-Signature: t=...,v1=..."
# Update
curl -X PUT "https://api.orqpay.com/v1/partner/merchants/{merchantId}/settlement-addresses" \
-H "Authorization: Bearer orq_pk_test_..." \
-H "X-Request-Signature: t=...,v1=..." \
-H "Content-Type: application/json" \
-d '{
"settlementAddresses": [
{ "networkId": 137, "address": "0x…" }
]
}'After a payment confirms, funds settle to these wallets.