Get Checkout Refundable Info

GET

/v2.0/payment/crypto/checkouts/{checkoutId}/refundable-info

Query a checkout order's currently refundable (settled), voidable (VOID) and KYT risk-refundable amounts. A category with no data is null. An order with nothing refundable still returns 200 with all three null.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200

application/json

Refundable info retrieved successfully

Bodyapplication/json

Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "checkoutId": "20260923000002351",
    "refundableItem": null,
    "voidableItems": null,
    "riskRefundableItems": {
      "items": [
        {
          "amount": {
            "amount": "1000.000000",
            "currency": "USDT"
          },
          "chainCode": "ETHEREUM"
        }
      ]
    }
  },
  "timestamp": 1790162405542,
  "logId": "6ab3b5e5e27a1462f37c324ad7185979"
}

🟠404NotFound

Modified at 2026-09-24 03:14:01

Get Crypto Refund

Refund Status Webhook