1. Payin
English
  • Chinese
  • English
  • Open API Documentation
  • Payin
    • Payin Order - General
    • Payin Order - India
    • Payin Order - Philippines
    • Payin Order - Indonesia
    • Payin Order - Vietnam
    • Payin Order - Cryptocurrency
    • Payin Order - China
    • Payin Order - Malaysia
    • Payin Order - Pakistan
    • Payin Order - Thailand
  • Payout
    • Payout Order - General
    • Payout Order - India
    • Payout Order - Philippines
    • Payout Order - Indonesia
    • Payout Order - Vietnam
    • Payout Order - Cryptocurrency
    • Payout Order - Malaysia
    • Payout Order - Pakistan
    • Payout Order - Thailand
  • Callback Notification
    • Callback Description
    • Collection Callback
    • Payout Callback
  • Query API
    • Collection Order Query
    • Payout Order Query
    • Wallet Query
  • Examples of encryption and signature
    • Go Language Encryption and Signature Example
    • Python Encryption and Signature Example
    • PHP encryption and signature example
    • Node.js encryption and signature example
    • Environment variables and request body JSON example
    • Java encryption and signature example
  • Other instructions
    • Response Status Description
    • Order Status Description
    • Payment Method List
    • Bank Code List
    • Checkout iframe Copy Function Support Description
    • Backend Login Instructions
  1. Payin

Payin Order - Cryptocurrency

Brief Description
Create Crypto Payin Order
Request URL
/api/v1/transactions
Request Method
POST
Request Format
Content-Type: application/json

Request Parameter Description#

Field NameTypeDescriptionRequiredExample
titleStringOrder titleNoPayment Order
order_noStringMerchant order number (Max 64 characters, must be unique)YesP120251222027
amountBigDecimalAmountYes1000
currencyStringPayment currencyYesUSDT
payment_methodStringPayment method code (see payment method list)YesUSDT_ERC20
callback_urlStringFull callback notification URLYeshttps://xxx/xxx
return_urlStringRedirect URL after payment completionYeshttps://xxx/xxx
return_typeStringResult return method. PLATFORM: Platform checkout page URL, CUSTOM: Custom checkout page data (qr_code), Default: PLATFORMNoCUSTOM
user_ipStringUser IPYes127.0.0.1
expire_secondsintOrder expiration time, in secondsNo3600
payerobjectPayer user informationYes
user_idStringUnique user identifier (account or ID)Yestest001

Response Parameter Description#

Field NameTypeDescription
codeintegerSuccess response code, see error codes for other exceptions
msgStringDescription
dataobject
trade_noStringPlatform transaction number
order_noStringMerchant order number
statusStringCurrent pay-in order status (please check status code description)
messageStringResponse description
amountStringOrder amount
due_pay_amountnumberAmount due
currencyStringOrder currency
feeStringTransaction fee
detailsobject
redirect_urlStringCheckout page URL
qr_codeStringQR code

Order Successful Response#

Response when return_type is PLATFORM#

Response when return_type is CUSTOM#

Response Failed#

Modified at 2026-06-01 11:49:56
Previous
Payin Order - Vietnam
Next
Payin Order - China
Built with