Settlement

This document describes the settlement process for ANexPay XCheckout.

Settlement Methods

Stablecoin Transfer
Transfer funds directly to a specified on-chain wallet address.

Fiat Payout
Convert stablecoins into fiat currency and remit to a designated bank account.

Call the createSettlementOrder API to initiate a settlement. Upon successful request, funds will be transferred to the specified destination.

Parameter	Type	Required	Description
`settlementOrderNo`	String	Yes	Unique settlement ID generated by your system
`amount`	Number	Yes	Settlement amount
`token`	String	Yes	Settlement token (refer to supported tokens)
`address`	String	Yes	Destination wallet address for settlement

You can retrieve settlement status via:

Subscribe to settlement-related events

Receive real-time updates when settlement status changes

Call the getSettlementInfo API to query settlement status

Address Accuracy
Ensure the destination wallet address is correct. Incorrect addresses may result in irreversible loss of funds.

Idempotency
Use a unique settlementOrderNo to prevent duplicate settlements.

Settlement Timing
Settlement completion depends on blockchain confirmation times—allow for network latency.

Validate wallet address format before submission

Log all settlement requests for audit and reconciliation

Use webhook + polling together for higher reliability