API Documentation📦 Submit Order

Overview

Used to generate payment data for specified cryptocurrencies. Merchants can redirect users to the XUSDT checkout page through the payment link. After successful payment, the system will send instant callback notifications.

Users must pay the exact order amount. If the payment amount does not match, the order cannot be processed.

Basic Information

ItemDescription
Request URL/api/v1/payment/order/create
MethodPOST
Content Typeapplication/json

Request Parameters

Required Parameters

Field NameTypeSign RequiredExampleDescription
app_idstringYesZu78qwe1Merchant ID
order_snstringYesOrder202409291231Merchant order number (must be unique)
chain_typenumberYes1Supported Chains:
• 1: TRC20
• 2: TRX20
pay_moneynumberYes50.98Payment amount
money_typestringYesUSDPayment currency type
notify_urlstringYeshttps://example.com/callbackCallback notification URL
redirect_urlstringYeshttps://example.com/successRedirect URL
signstringYes6F3B90783FABE56DBB771D03E0EAADD0Signature parameter, sorted by ASCII code, MD5 encrypted and converted to uppercase

Optional Parameters

Field NameTypeSign RequiredExampleDescription
attachstringNocustom_dataAdditional data, returned unchanged in callback
product_namestringNoT-shirtProduct name
product_descstringNoProduct descriptionProduct details
product_numnumberNo1Product quantity
pay_usernamestringNojohn_doeUsername

Supported Currencies

Click to view supported currencies
  • USD (US Dollar)
  • CNY (Chinese Yuan)
  • INR (Indian Rupee)
  • JPY (Japanese Yen)
  • KRW (Korean Won)
  • PHP (Philippine Peso)
  • EUR (Euro)
  • GBP (British Pound)
  • CHF (Swiss Franc)
  • TWD (Taiwan Dollar)
  • HKD (Hong Kong Dollar)
  • MOP (Macau Pataca)
  • SGD (Singapore Dollar)
  • NZD (New Zealand Dollar)
  • THB (Thai Baht)
  • CAD (Canadian Dollar)
  • ZAR (South African Rand)
  • BRL (Brazilian Real)

Response Parameters

Field NameTypeDescription
order_nostringMerchant order number
pay_addressstringPayment address
pay_moneynumberPayment amount
pay_urlstringCheckout page URL
statusnumberOrder status