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	Fixed value: EWALLET
inBankCode	Yes	String	[Network Protocol](#Network Protocol and Currency), FIX_TRX
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.

Network Protocol and Currency

Supported Currency	inBankCode (value used in the request)	Network Protocol Name
USDT	FIX_TRX	TRX (Tron/TRC20)

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 [Network Protocol and Currency](#Network Protocol and Currency) 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.