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
| Header | Required | Description |
|---|---|---|
Idempotency-Key | no | 8–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
| Field | Type | Required | Description |
|---|---|---|---|
sWalletAddress | string | yes | Source 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
| Status | Meaning |
|---|---|
400 | Invalid sWalletAddress; insufficient balance (response includes nBalanceSol, nRequiredSol); or the wallet would be left below the rent-exempt minimum. |
403 | The wallet was imported through /wallets/import and is reserved for Smart Sell. |
404 | No unpaid Makers order, or wallet not found / not owned. |
502 | The transfer was not confirmed. |
503 | Balance 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": "…" }'