Query a Charge

Retrieve the full detail and current status of a single charge by its ID. Use this endpoint to poll for the final SUCCESS or FAILED outcome after creating a charge.
Request Parameters
idstring
required
Unique identifier of the charge to retrieve, returned by Create a Charge.
Response Parameters
resultResult
API call result. See Result.
idstring
Unique identifier of the charge.
requestIdstring
Idempotency key echoed from the original create request.
sourceAccountIdstring
Identifier of the merchant account that is debited.
chargeAmountAmount
Amount deducted, including currency and value. See Data Types.
chargeCategorystring
Business category of the charge. See ChargeCategory.
statusstring
Current status of the charge.

Valid Values:

PROCESSING — The charge is being processed asynchronously.
SUCCESS — The charge was deducted successfully (terminal).
FAILED — The charge could not be completed (terminal).
referenceOrderIdstring
Partner-side order or reference number. Returned only when it was provided at creation.
transferMemostring
Free-text note. Returned only when it was provided at creation.
feeAmountAmount
Fee charged for processing this charge, including currency and value. Returned when a fee applies. See Data Types.
feeRatedecimal
Fee rate applied to this charge, expressed as a decimal (e.g., 0.006 for 0.6%). Returned when a rate-based fee applies.
failureCodestring
Machine-readable reason the charge failed. Returned when status is FAILED.

Valid Values:

RISK_REJECT — The charge was rejected by risk control.
BALANCE_NOT_ENOUGH — The source account balance was insufficient.
ACCOUNT_UNAVAILABLE — The source account was unavailable (e.g., frozen or closed).
failureMessagestring
Human-readable description of the failure. Returned when status is FAILED.
createdAtdatetime
Time the charge was created, following the ISO 8601 standard. See Data Types.
updatedAtdatetime
Time the charge was last updated, following the ISO 8601 standard. See Data Types.
completedAtdatetime
Time the charge reached a terminal status. Returned when status is SUCCESS or FAILED. Follows the ISO 8601 standard. See Data Types.
Error Codes
resultCoderesultStatusresultMessageTroubleshooting
SUCCESSSsuccessN/A
PARAM_ILLEGALFIllegal parameters. Refer to the API documentation to verify the request parameters, then retry.Ensure `id` is a non-empty valid charge identifier.
ORDER_NOT_FOUNDFThe charge was not found.Verify `id` refers to a charge that exists and belongs to the calling partner.
Definition
POST /api/open/v1/charges/query
Request
{
"id": "20260808000000098765"
}
Response
{
"result": {
  "resultCode": "SUCCESS",
  "resultStatus": "S",
  "resultMessage": "success"
},
"id": "20260808000000098765",
"requestId": "req_c1h2a3r4",
"sourceAccountId": "20260101000000067890",
"chargeAmount": {
  "currency": "USD",
  "value": 1000
},
"chargeCategory": "PLATFORM_FEE",
"status": "SUCCESS",
"referenceOrderId": "order_20260808001",
"transferMemo": "August platform service fee",
"feeAmount": {
  "currency": "USD",
  "value": 6
},
"feeRate": "0.006",
"createdAt": "2026-08-08T08:00:00+08:00",
"updatedAt": "2026-08-08T08:00:05+08:00",
"completedAt": "2026-08-08T08:00:05+08:00"
}