Create Checkout

Create a new crypto checkout order.

buyerInfo field requirements

buyerInfo is optional in general. If provided, the required fields depend on buyer type and order amount.
Gateway-level validation: if buyerInfo is present, firstName + lastName (individual) or companyName (corporate) are always required.
When paymentMethod is provided, buyerInfo becomes mandatory and must be complete.

Individual Buyer (IndividualBuyerInfo2)

Description	Fields	<1000 USD	≥1000 USD
fullLegalName	firstName, lastName	mandatory	mandatory
residentialAddress	residentialAddress.country, residentialAddress.addressLine1	—	mandatory: pick one of the three
identityNumber	identityType, identityNumber	—	mandatory: pick one of the three
dateOfBirth & placeOfBirth	dateOfBirth (YYYY-MM-DD), placeOfBirth (Country, ISO 3166-1 alpha-2)	—	mandatory: pick one of the three

Corporate Buyer (CorporateBuyerInfo)

Description	Fields	<1000 USD	≥1000 USD
companyName	companyName	mandatory	mandatory
registeredAddress	registeredAddress.country, registeredAddress.addressLine1	—	mandatory: pick one of the three
businessRegistrationNumber	businessRegistrationNumber	—	mandatory: pick one of the three
dateOfRegistration & countryOfIncorporation	dateOfRegistration (YYYY-MM-DD), countryOfIncorporation (Country, ISO 3166-1 alpha-2)	—	mandatory: pick one of the three

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": "B0100348",
    "orderAmount": {
        "amount": "10.00",
        "currency": "USD"
    },
    "clientCheckoutId": "ORDER-20260803-001",
    "expiry": 1800000000000,
    "buyerInfo": {
        "firstName": "Alice",
        "lastName": "Smith",
        "identityType": "PASSPORT",
        "identityNumber": "E1234567"
    },
    "productInfo": {
        "productName": "Premium Plan"
    },
    "checkoutConfiguration": {
        "merchantName": "MyStore",
        "feeBearer": "MERCHANT",
        "defaultLanguage": "ENGLISH"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Checkout created successfully

Bodyapplication/json

Example

{
    "code": "string",
    "msg": "Crypto checkout created successfully",
    "data": {
        "checkoutId": "20260708000003222",
        "participantCode": "A0102960",
        "clientCheckoutId": "client_12345",
        "checkoutUrl": "string",
        "orderAmount": {
            "amount": "string",
            "currency": "string"
        },
        "referenceAmount": {
            "referenceAmount": {},
            "referencePrice": "string"
        },
        "settleAmount": {
            "amount": "string",
            "currency": "string"
        },
        "email": "string",
        "quotationId": "string",
        "quotationExpiry": 0,
        "checkoutExpiry": 0,
        "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
    }
}