Partners
Payments
Create a checkout payment for one of your merchants.
Create a payment for a merchant, send the buyer to hosted checkout, and fulfill when the webhook says it is paid.
There is no list endpoint — store id from create responses and from webhooks.
Create
curl -X POST "https://api.orqpay.com/v1/partner/payments" \
-H "Authorization: Bearer orq_pk_test_..." \
-H "X-Request-Signature: t=...,v1=..." \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"merchantId": "…",
"amount": "10.00",
"email": "[email protected]",
"token": "USDC",
"referenceId": "your-order-id",
"successUrl": "https://your-app.example/success",
"cancelUrl": "https://your-app.example/cancel"
}'Use the response:
- Save
id - Send the buyer to
checkoutUrl
Useful options
| Field | Use |
|---|---|
referenceId | Your order id |
token / networkId | Limit asset or network |
externalUserId | Your user id for the payer |
successUrl / cancelUrl | Return URLs after checkout |
Look up a payment
curl "https://api.orqpay.com/v1/partner/payments/{id}?merchantId=…" \
-H "Authorization: Bearer orq_pk_test_..." \
-H "X-Request-Signature: t=...,v1=..."Fulfill
Listen for invoice.paid on your partner webhook. Details: Webhooks.
For status meanings, see the merchant guide: Payment status.