Skip to main content

POST /makers/pay

Pay the unpaid Makers order from one of the user's wallets.

Sends the SOL the order still lacks from the wallet to the user's payment address. Sync — waits for tx confirmation and returns the signature. If the payment address already holds enough SOL, nothing is sent.

Headers​

HeaderRequiredDescription
Idempotency-Keyno8–128 chars of [A-Za-z0-9_-]. A retry with the same key within 24 hours returns the first response (with Idempotent-Replayed: true) instead of sending a second payment. 409 while the first request is still running; 503 if idempotency is unavailable.

Body​

FieldTypeRequiredDescription
sWalletAddressstringyesSource pubkey; must be user-owned.

Response 200​

{
"message": "Payment sent",
"paymentAddress": "…",
"sFrom": "…",
"nSol": 1.25,
"signature": "3k…"
}

When the payment address already covers the order:

{
"message": "The payment address already covers this order",
"paymentAddress": "…",
"nSol": 0
}

Errors​

StatusMeaning
400Invalid sWalletAddress; insufficient balance (response includes nBalanceSol, nRequiredSol); or the wallet would be left below the rent-exempt minimum.
403The wallet was imported through /wallets/import and is reserved for Smart Sell.
404No unpaid Makers order, or wallet not found / not owned.
502The transfer was not confirmed.
503Balance could not be fetched; retry later.

Example​

curl -X POST "$BASE_URL/makers/pay" \
-H "Authorization: Bearer $ACCESS" \
-H "x-user-id: $USER_ID" \
-H "Idempotency-Key: pay-6731-0001" \
-H "Content-Type: application/json" \
-d '{ "sWalletAddress": "…" }'