The Airwallex Customs Declaration functionality enables Merchants who sell goods to mainland China via bonded warehouses to send payment information to China Customs conveniently and safely as regulated.
Currently, this service supports custom declarations for WeChat Pay transactions that are completed within a year.
To help you better understand what role Airwallex plays in your declaration process and what functionality our customs declaration API delivers, the Customs Declaration Model below illustrates the major parties in your overall declaration procedures.
The customer completes the purchase.
You, as the merchant, shall send custom details and receives payment data via Airwallex Customs Declaration API (see guideline below).
Same as your common practices of completing declaration, it is your responsibility to inform the logistics to send shipment details for declaration, with payment data attached. Also, you need to send order details for declaration, with payment data attached.
After the customs receives all the required information, they will cross-check the detailed information of the order sent by you, payment methods and logistics. If details matched, customs will agree the merchant to dispatch goods.
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
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.
This feature is still under testing. If you are interested in this functionality, you are more than welcomed to contact us for further information.
|Customs Name||Customs Name (CN)||Customs Code||Notes|
|Guangzhou (General Administration)||广州（总署版）||GUANGZHOU_ZS|
|Guangzhou HuangPu CIQ||广州黄埔国检||GUANGZHOU_HP_GJ||Orders that are required to be pushed to Huangpu CIQ shall be separately pushed to Guangzhou (General Administration) and Guangzhou Huangpu CIQ, i.e. the |
|Guangzhou Nansha CIQ||广州南沙国检||GUANGZHOU_NS_GJ||Orders that are required to be pushed to Nansha CIQ shall be separately pushed to Guangzhou (General Administration) and Guangzhou Nansha CIQ, i.e. the |
|Hangzhou (General Administration)||杭州（总署版）||HANGZHOU_ZS|
|Zhengzhou (Bonded Logistics Center)||郑州（保税物流中心）||ZHENGZHOU_BS|
|Shanghai (General Administration)||上海（总署版）||SHANGHAI_ZS|
|Zhengzhou Integrated Bonded Area (General Administration)||郑州综保（总署版）||ZHENGZHOU_ZH_ZS|
|Tianjin||天津||TIANJIN||To push your order to Tianjin Customs, you need to provide both Tianjin Customs and TJCIQ registration information to us. You only need to call the |