Initiate a Payable Consumption

POST

/crypto/consume/pay

This endpoint is used to initiate a payable consumption process, supporting payment on multiple blockchains (Ethereum, BSC, Tron) and tokens (USDT, USDC). It validates the request, processes the payment, and returns a sequence ID and order identifiers.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Result structure, data field is the response body

Body

🟠400Bad Request

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/crypto/consume/pay' \
--header 'access_key;' \
--header 'timestamp;' \
--header 'nonce;' \
--header 'sign;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "chainType": "Bsc",
    "expireByMinute": 1440,
    "externalOrderId": "ORDER1234567890123",
    "hideMerchantLogo": true,
    "hideMerchantName": false,
    "imageUrl": "https://cdn.example.com/item.png",
    "merchantOrderId": "EXT123456789",
    "notifyUrl": "https://your.com/notify",
    "productName": "iPhone 15",
    "quantity": 2,
    "remark": "VIP customer priority",
    "successRedirectUrl": "https://your.com/success",
    "tokenType": "USDT",
    "tokenValue": 8999.12,
    "unitPrice": 6999,
    "usePoints": 100
}'

Response Example

200 - Example 1

{
    "code": "string",
    "data": {
        "cashierExpireTime": 1440,
        "cashierUrl": "https://cashier.example.com/order/ORD20250626101001",
        "chainType": "Bsc",
        "externalOrderId": "ORDER123456789",
        "orderId": "ORD20250626101001",
        "orderStatus": "PENDING",
        "sequence": 1234567890,
        "toAddress": "0x1234567890abcdef1234567890abcdef12345678",
        "tokenType": "USDT",
        "tokenValue": 8999.12
    },
    "desc": "string",
    "msg": "string",
    "success": true
}

Modified at 2025-07-08 08:04:25

Query Supported Blockchain Types