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/json

Example

{
  "participantCode": "B0100348",
  "orderAmount": {"amount": "10.00", "currency": "USD"},
  "orderCurrency": "USD",
  "expiry": 1800000000000,
  "clientCheckoutId": "order-001",
  "buyerInfo": {"firstName": "Alice", "lastName": "Smith"},
  "productInfo": {"productName": "Premium Plan"},
  "checkoutConfiguration": {"merchantName": "MyStore", "defaultLanguage": "ENGLISH"}
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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": 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",
        "referenceAmount": {
            "referenceAmount": {
                "amount": "string",
                "currency": "string"
            },
            "referencePrice": "string"
        },
        "settleAmount": {
            "amount": "string",
            "currency": "string"
        },
        "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