POST /split/orders/:orderId/check-payment
Check whether an EXTERNAL order has been paid. Reads the deposit
address balance and, once it covers the order, marks the order FUNDED
so the worker can execute it.
Use case
Call after sending SOL to sDepositAddress (the "Check & Continue"
step).
Path params
| Param | Required | Description |
|---|---|---|
orderId | yes | Split order id. |
Response 200
{
"orderId": "665f1c2e9b1d4a0012345678",
"eStatus": "PENDING_DEPOSIT",
"nReceivedSOL": 1.5,
"nRequiredSOL": 2
}
| Field | Description |
|---|---|
eStatus | FUNDED when the payment is sufficient, otherwise PENDING_DEPOSIT. |
nReceivedSOL | SOL currently on the deposit address. |
nRequiredSOL | SOL required. |
Errors
| Status | Meaning |
|---|---|
400 | orderId malformed. |
404 | Order not found or not yours. |
409 | Order is not an unpaid EXTERNAL order. |
Example
curl -X POST "$BASE_URL/split/orders/<orderId>/check-payment" \
-H "Authorization: Bearer $ACCESS" -H "x-user-id: $USER_ID"