Quickstart
Create your first payment and fulfill when it is paid.
Get a buyer from “create payment” to “paid” in three steps.
Building for many merchants? Start at Partners.
1. Get credentials
In the merchant dashboard → API keys:
- Create a test API key (
orq_mk_test_…) - Issue your signing secret (
orq_ms_…) - Add a webhook URL for test events
Use the Request signer to build signed requests while you integrate.
2. Create a payment
curl -X POST https://api.orqpay.com/v1/payments \
-H "Authorization: Bearer orq_mk_test_..." \
-H "X-Request-Signature: t=...,v1=..." \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"amount": "10.00",
"email": "[email protected]",
"token": "USDC"
}'From the response:
- Save
id— you will need it later - Send the buyer to
checkoutUrl
Optional fields:
| Field | Use |
|---|---|
referenceId | Your order or cart id |
successUrl / cancelUrl | Where to send the buyer after checkout |
token / networkId | Limit which asset or network they can pay on |
3. Fulfill when paid
Listen for webhook event invoice.paid, then ship or credit the order.
The payment id is data.paymentId.
You can also call GET /v1/payments/{id} with the id you stored. There is no public payment list — keep ids in your system.
Next
- Payment status — when it is safe to fulfill
- Webhooks — verify deliveries
- Authentication — keys and signing
- API reference