Development Guidelines
Update Time:2025.03.24The development guidelines introduce the cross-border funds-distribution in detail. The merchant's developer can read the development guidelines and complete the access process by referring to[API Document].
1. Preconditions
Read【Product Introduction】and understand the basic functions and usage scenarios of the funds-distribution product;
Read【Preparation Before Access】and prepare AppID, merchant certificates, other relevant parameters and documents;
Read【API Rules】,and understand the basic conventions of WeChat Pay API V3, such as authentication options, request rules, data format, parameter compatibility, and error handling.
2. Flowchart
Key Steps
Mark transaction with "funds-distribution"
See【funds-distribution Mark API】for details: Before a merchant transaction, call the API to mark it with "funds-distribution", indicating that the transaction will subsequently be subject to the funds-distribution function. After the payment is completed, the transaction funds will be frozen in the merchant's account, waiting for the funds-distribution command or unfreeze remaining funds command from the merchant to distribute the funds.
Note: The mark API must be called before the merchant calls the transaction API, and its parameters must be consistent with those of the transaction API (sub-merchant, transaction ID and price currency). Otherwise, the funds-distribution mark will be invalid.
Merchants adding receivers
Before calling【funds-distribution Request API】, the merchant needs to add a receiver and submit relevant documents to prove the relationship of the funds receiver for compliance verification. The merchant can call【Adding Receiver Result Query API】to query the result of adding a receiver. After successful addition (after the submitted documents are approved), the funds can be distributed to the receiver.