Warning

Before reading this API documentation, please review the API Documentation Guide

Collection API

Collection Application

Brief Description:

• Create a collection order.

This address is permanent, please review the Notes before integration.

URL:

USDT

/usdt/collect/apply Description: appId USDT, settlement in USDT.

Parameters:

Parameter Name	Required	Type	Description
appId	Yes	Long	Business ID (obtained from the backend, needs to be passed according to the currency in the URL)
payType	Yes	String	payType
inBankCode	Yes	String	inBankCode
sign	Yes	String	Signature

Return data parameter description:

Parameter Name	Type	Description
payUrl	String	Payment link
bankNo	String	Address (wallet address)
sign	String	Signature

Asynchronous Notification

URL: Your provided URL

Parameters:

Parameter Name	Type	Description
appId	Long	Business ID
currency	String	Currency
orderId	String	Merchant order number, different for each callback
orderNo	String	Platform order number, different for each callback
amount	String	Amount received
fee	String	Service fee
status	Integer	Status (2 for successful collection)
payTime	String	Payment successful time (New York time), format: yyyy-MM-dd HH:mm:ss
hash	String	Transaction hash
sign	String	Signature

Request:

{
    "appId": 10002,
    "currency": "USD",
    "orderId": "M123456789",
    "orderNo": "PLAT123456789",
    "amount": "21.00",
    "fee": "1.00",
    "status": 2,
    "payTime": "2024-03-01 23:59:59",
    "sign": "SIGN123456789"
}

Note: After receiving the callback notification, please return SUCCESS (uppercase) or the system will continue to notify 5 times.

Payment Methods

Currency	Payment Type (payType)	Payment Code (inBankCode)	Limit	Status	Description
USDT	EWALLET	FIX_TRX	1-200000	Available	USDT on TRON chain, TRC-20 token standard

Notes

1. The address after placing the order is permanent. After each payment, a callback will be triggered, and the platform order number (orderNo) and merchant order number (orderId) will be different each time. However, the same order will trigger repeated callbacks (up to 5 retries) with the same values.

2. If a collection address already exists for a particular network protocol, the requested currencies will be updated to the already bound address. The update method is overwrite, and the original currency will no longer be supported. Please proceed with caution.

3. Only the selected Payment Methods can be used for the order. Unselected currencies are not supported for payment. If funds are forcefully transferred, they will not be credited and no callback notification will occur. To avoid financial loss, please confirm before making the payment.