Settlement

This article describes the W Checkout settlement process.

Settlement Methods

Stablecoin Transfer
Transfer funds directly to the external on-chain address specified by the client.

Fiat Withdrawal
Convert stablecoins into fiat currency and remit it to the client's designated bank account.

Create a Settlement Order

Call the createSettlementOrder interface to initiate settlement. Upon successful request, tokens will be settled to the receiving address you specify.

Request Parameters

Parameter Name	Type	Required	Description
settlementOrderNo	String	Yes	A unique settlement order number generated by the client system to identify this settlement transaction.
amount	Number	Yes	The amount to be settled in this transaction.
token	String	Yes	The token for this settlement. Refer to Supported Blockchains and Tokens.
address	String	Yes	The on-chain receiving address for this settlement.

Retrieve Settlement Order Status

You can obtain the settlement order status through the following methods:

Webhook Notification

Subscribe to settlement-related events. The system will push notifications when the settlement status changes.

API Query

Call the getSettlementInfo interface to query the settlement order status.

Developer Notes

Settlement Address Security: Ensure the provided receiving address is accurate. An incorrect address may result in fund loss.

Idempotency: It is recommended to use a unique settlementOrderNo when calling the settlement interface to prevent duplicate settlements.

Arrival Time: Settlement arrival depends on blockchain network confirmation times. Please account for processing delays.

Settlement Methods#

Create a Settlement Order#

Request Parameters#

Retrieve Settlement Order Status#

Developer Notes#

Settlement Methods

Create a Settlement Order

Request Parameters

Retrieve Settlement Order Status

Developer Notes