Customs Declaration - WeChat Pay

The following guideline will walk you through the process of using Airwallex Customs Declaration service to Create, Update, Retrieve and Redeclare your order. You shall start with creating a customs declaration first and please refer to our API reference for the complete details of the calls.

Create a Customs Declaration

Create a Customs Declaration to send payment information to the customs. Your request should include the payment_intent_id to specify the payment you want to declare. You will also need to provide customs related information so that we can send the payment information to the right customs. In each request, sub_order fields are required, and if there is no need to split your original order, please fill the suborder fields with your original order information for declaration.

Pass in the shopper_details object if you want to verify the shopper identity you collected from the checkout page with the payer identity in the WeChat system. This could help you align the shopper identity with the payer identity during the order information declaration as required.

Please note that you need to provide your customs registration information to us offline in advance for configuration purposes.

After you succeed to create a declaration, the response of the Customs Declaration is provided below and contains an id, it is the unique number generated by Airwallex for the declaration and you will need to use it to Retrieve, Update and Redeclare the declaration. We will also return provider_order_id to you, you need to use it as institution transaction id when sending shipment and order information to customs.

It may take several minutes to complete the declaration process. It is possible for you to get PROCESSING status in the response. You are suggested to call the Retrieve a customs declaration API a few minutes later than your creation. The status will turn to “SUCCEEDED” once your declaration succeeds.

If the value of shopper_identity_check_result is “DIFFERENT”, you shall require the shopper to revise the shopper identity provided in the order to align with the payer identity they set in WeChat Pay. After you get the new identity information, you shall call the Update a customs declaration API and update the identity information of the previous declaration.

Also, you shall request the Create API to create a Customs Declaration again, under the case that your request has failed. You will get another id for this successful declaration request.

Update a Customs Declaration

Update the existing Customs Declaration to align with your actual declaration demand. Use the Update API when you need to update the fee, customs, merchant_customs_no from your previous declaration. Note that the declaration under PROCESSING status can not be updated.

For your convenience, we developed a unified format for the response in our Customs Declaration API. You will obtain a response the same format as the Create API one. You can update the shopper_details object until it matches with the payer identity in the WeChat Pay system ("shopper_identity_check_result": "SAME") .

Retrieve a Customs Declaration

Retrieve a customs declaration to obtain the updated status of the declaration earlier submitted.

You will get a response with the latest update on the declaration status.

Redeclare a Customs Declaration

Redeclare the Customs Declaration which failed during the customs’ verification process . In some instances the information you provide and the information received by the customs may differ. If you receive “payment information does not exist” response when inquiring customs for customs declaration result. In this case, leverage the Redeclare API to send the original payment information again to the customs. Note that you will not get a new id by requesting the Redeclare API.

You will get a response with the same format as above responses.

After requesting the Customs Declaration APIs, you may be returned with errors and their descriptions correspondingly.

• If errors are returned after requesting the Create API, it actually means you did not create the declaration successfully. In this case, you shall refer to the error code section in the API doc to correct your declaration fields and request the Create API again to finish creating the declaration successfully. This is the most common case you would receive error response after request.
• If errors are returned after requesting the Update, Retrieve and Redeclare API, it also means your previous request is considered as failed. You shall correct your declaration and call the corresponding API again to complete your request.

WeChat