China Payout

Prefix: /api/v1/merchant. Auth: Signature.

Create payout

POST /api/v1/merchant/payout/create

Field	Required	Notes
merchantOrderNo	yes	Unique
countryCode	yes	CN
currency	yes	CNY
amount	yes	Beneficiary amount (CNY)
receiverName	yes	Must match bank account name
receiverAccount	yes	Bank card number
receiverBankName	yes	Full bank name
receiverBankCode	recommended	CNAPS / bank code
receiverPhone	no
notifyUrl	no	Falls back to callbackUrl
metadata	no	e.g. { "branch": "..." }

Freezes netAmount = amount + fee. payoutMethod is BANK_TRANSFER.

Query payout

GET /api/v1/merchant/payout/query?orderNo= or ?merchantOrderNo=

Webhook (completed)

Full checklist: Webhook guide.

POST JSON with signed headers. Body includes "orderType": "payout", "status": "completed", countryCode: "CN", currency: "CNY".

Respond 200 + OK. No webhook on cancelled / failed.

Statuses: created, market_available, processing, completed, failed, cancelled.