Skip to main content

GET /aged-wallets/status/:orderId

Fetch one order and check its payment. While the order is unpaid the deposit address is read live; an unpaid order past its window is closed as EXPIRED.

Use case​

Poll after paying until eStatus becomes FULFILLED.

Path params​

ParamRequiredDescription
orderIdyesAged-wallets order id.

Response 200​

The order object (same shape as in initialize). While eStatus is PENDING_PAYMENT two extra fields are added:

{
"orderId": "665f1c2e9b1d4a0012345678",
"eStatus": "PENDING_PAYMENT",
"nTotalSOL": 0.1,
"sDepositAddress": "<deposit address>",
"nDepositSOL": 0.1,
"bPaymentDetected": true
}

(other order fields omitted here)

FieldDescription
eStatusPENDING_PAYMENT, PROCESSING, PAID, FULFILLED, EXPIRED, CANCELLED or FAILED.
nDepositSOLSOL currently on the deposit address (unpaid orders only).
bPaymentDetectedtrue once the deposit covers nTotalSOL (unpaid orders only).
aWalletsWallet public keys; empty until FULFILLED.
sErrorFailure reason, if any.

Errors​

StatusMeaning
400orderId malformed.
404Order not found or not yours.

Example​

curl -H "Authorization: Bearer $ACCESS" -H "x-user-id: $USER_ID" \
"$BASE_URL/aged-wallets/status/<orderId>"