Create Checkout

POST

/v2.0/payment/crypto/checkouts

Create a new crypto checkout order.

Mandatory buyer info:

field	Individual Buyer (<1000 USD)	Individual Buyer (≥1000 USD)
firstName & lastName	mandatory	mandatory
residentialAddress	-	mandatory

field	Corporate Buyer (<1000 USD)	Corporate Buyer (≥1000 USD)
companyName	mandatory	mandatory
registeredAddress	-	mandatory

paymentMethod:
If use MCE checkout Page, paymentMethod is not needed.
If use your own checkout Page, payment Method is mandatory.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/jsonRequired

Example

{
    "participantCode": "MERCHANT_001",
    "orderAmount": {
        "amount": "string",
        "currency": "string"
    },
    "clientCheckoutId": "ORDER_12345",
    "expiry": 1705320000000,
    "buyerInfo": {
        "firstName": "John",
        "middleName": "string",
        "lastName": "Doe",
        "identityType": "PASSPORT",
        "identityNumber": "A12345678",
        "dateOfBirth": "1990-01-15",
        "placeOfBirth": "New York, USA",
        "nationality": "US",
        "residentialAddress": {
            "country": "SG",
            "state": "Central Region",
            "city": "Singapore",
            "postcode": "018989",
            "addressLine1": "1 Raffles Place",
            "addressLine2": "#40-02"
        }
    },
    "productInfo": {
        "productName": "iPhone 15 Pro",
        "description": "256GB, Space Black",
        "productImageUrl": "https://example.com/product.jpg"
    },
    "checkoutConfiguration": {
        "merchantName": "Apple Store Singapore",
        "merchantLogo": "https://example.com/logo.png",
        "feeBearer": "BUYER",
        "redirectUrl": "https://merchant.com/payment/callback",
        "customerSupportEmail": "support@merchant.com",
        "defaultLanguage": "ENGLISH"
    },
    "paymentMethod": {
        "paymentCurrency": "USDT",
        "blockchain": "ETHEREUM",
        "quotationId": "string",
        "email": "12345678@163.COM"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v2.0/payment/crypto/checkouts' \
--header 'Content-Type: application/json' \
--data-raw '{
    "participantCode": "MERCHANT_001",
    "orderAmount": {
        "amount": "string",
        "currency": "string"
    },
    "clientCheckoutId": "ORDER_12345",
    "expiry": 1705320000000,
    "buyerInfo": {
        "firstName": "John",
        "middleName": "string",
        "lastName": "Doe",
        "identityType": "PASSPORT",
        "identityNumber": "A12345678",
        "dateOfBirth": "1990-01-15",
        "placeOfBirth": "New York, USA",
        "nationality": "US",
        "residentialAddress": {
            "country": "SG",
            "state": "Central Region",
            "city": "Singapore",
            "postcode": "018989",
            "addressLine1": "1 Raffles Place",
            "addressLine2": "#40-02"
        }
    },
    "productInfo": {
        "productName": "iPhone 15 Pro",
        "description": "256GB, Space Black",
        "productImageUrl": "https://example.com/product.jpg"
    },
    "checkoutConfiguration": {
        "merchantName": "Apple Store Singapore",
        "merchantLogo": "https://example.com/logo.png",
        "feeBearer": "BUYER",
        "redirectUrl": "https://merchant.com/payment/callback",
        "customerSupportEmail": "support@merchant.com",
        "defaultLanguage": "ENGLISH"
    },
    "paymentMethod": {
        "paymentCurrency": "USDT",
        "blockchain": "ETHEREUM",
        "quotationId": "string",
        "email": "12345678@163.COM"
    }
}'

Responses

🟢200

application/json

Checkout created successfully

Bodyapplication/json

Example

{
    "code": "SUCCESS",
    "msg": "Crypto checkout created successfully",
    "data": {
        "checkoutId": "20260708000003222",
        "participantCode": "A0102960",
        "clientCheckoutId": "client_12345",
        "checkoutUrl": "string",
        "orderAmount": {
            "amount": "string",
            "currency": "string"
        },
        "email": "string",
        "quotationId": "string",
        "quotationExpiry": "string",
        "checkoutExpiry": "string",
        "paymentAmount": {
            "amount": "string",
            "currency": "string"
        },
        "payerFeeAmount": {
            "amount": "string",
            "currency": "string"
        },
        "payeeFeeAmount": {
            "amount": "string",
            "currency": "string"
        },
        "paymentMethod": {
            "price": "1.005",
            "blockchain": "TRC20",
            "checkoutWallet": "TXYZabc123...",
            "qrCode": "data:image/png;base64,iVBORw0KGgoAAAANS..."
        },
        "status": "OPENING",
        "acceptableCryptos ": [
            {
                "cryptoCurrency ": "string",
                "blockchains": [
                    "string"
                ]
            }
        ],
        "checkoutConfiguration": {
            "merchantName": "Apple Store Singapore",
            "merchantLogo": "https://example.com/logo.png",
            "feeBearer": "BUYER",
            "redirectUrl": "https://merchant.com/payment/callback",
            "customerSupportEmail": "support@merchant.com",
            "defaultLanguage": "ENGLISH"
        },
        "createdAt": 0
    }
}

🟠400BadRequest

🟠401Unauthorized

Modified at 2026-07-24 07:27:12

Crypto Refund Webhook

Create Crypto Quotation