Adding Receiver API
The merchant initiates a request to add receiver and create a receiver list. The settled funds of the merchant can be distributed to the receiver by requesting funds-distribution.
1. A funds-receiver relationship involves the funds-distribution initiator and receiver:
Where the funds-distribution initiator refers to [merchant] or [merchant and sub-merchant] (Direct-connected merchant ID in direct mode and parent merchant/sub-merchant IDs in the service provider/overseas institution mode);
The receiver refers to the personal WeChat account number or merchant ID that receives the distributed funds. The merchant needs to provide the receiver type and receiver account when adding receiver information;
For example, in the overseas institutional mode, there are two sub-merchants A1 and A2 under merchant A. B1 is the partner of A1 and B2 is the partner of A2;
—— In this case, in order to further distribute funds to sub-merchant B1 based on the funds-distribution to sub-merchant A1, the merchant A needs to add receivers: mchid:A + sub_mchid: A1 + account: B1;
——In order to further distribute funds to sub-merchant B2 based on the funds-distribution to sub-merchant A2, merchant A needs to add receivers: mchid:A + sub_mchid: A2 + account: B2;
2. Before initiating the request to add a receiver, the merchant needs to call the overseas file upload API to submit the attachments for WeChat to audit the receiver relationship. Prepare the following partnership documents in advance. If the materials are not fully uploaded, they may not be approved.
【Description of partnership documents】
a. Partnership contract between both parties:
When the receiver is a domestic enterprise, the electronic scan of the cooperation contract between the cross-border e-commerce and the receiver should be submitted (mandatory). When the receiver is a domestic individual, for each sub-merchant (of cross-border e-commerce), it is only necessary to provide a sample to prove the cooperation relationship between cross-border e-commerce and a domestic individual.
b. See Sub-merchant’s Application and Commitment for Adding Receivers for the template of .receiver application letter.
Note: Two documents can be submitted and used separately. the file upload API. After obtaining the file ID, fill in the [file_id] field.
3. After the API is called successfully, the receiver relationship status is INIT. After the receiver's documents are approved by WeChat and the status of the receiver relationship is reversed to EFFECTIVE, the Funds-distribution Request API can be called to add receiver. Call Adding Receiver Result Query API to confirm whether the receiver relationship has taken effect (approved).
4. If the receiver relationship fails in the audit, re-submit the complete and conforming documents through the file upload API according to the reason for failure prompt field and re-initiate the request to add receiver Note: Initiating a request to add receiver in INIT/EFFECTIVE status is not allowed.