Customs declaration: Create

This resource can also be used to submit a new request if your initial request fails with an error and needs to be resubmitted. Once a submission has a status of successful it can no longer be resubmitted using this route. Please refer to the PATCH route to resubmit any modifications.

Request

POST https://api.gyro-n.money/stores/{storeId}/charges/{chargeId}/customs

Parameters:

Parameters
declarationobject [Required]
The information to be passed to the customs authorities for declaration.
Brand: we_chat_online
Parameters
declaration.customsstring [Required]
The customs authority.

One of:
GUANGZHOU_ZS – Guangzhou (General Administration)
GUANGZHOU_HP_GJ – Guangzhou HuangPu CIQ
GUANGZHOU_NS_GJ – Guangzhou Nansha CIQ – Hangzhou (General Administration)
HANGZHOU_ZS – Hangzhou (General Administration)
NINGBO – Ningbo
ZHENGZHOU_BS – Zhengzhou (Bonded Logistics Center)
CHONGQING – Chongqing
SHANGHAI_ZS – Shanghai (General Administration)
SHENZHEN – Shenzhen
ZHENGZHOU_ZH_ZS – Zhengzhou Integrated Bonded Area (General Administration)
TIANJIN – Tianjin
declaration.merchant_customs_nostring [Required]
The merchant’s customs registration number.
declaration.certificate_idstring [Required]
The customer’s national identification number.
declaration.certificate_namestring [Required]
The customer’s name on the national identification card.

Headers:

Content-Type: application/json
Authorization: Bearer {secret}.{jwt}

Body:

curl --request POST \
--url https://api.gyro-n.money/stores/11ec0537-5a17-7490-8f44-97e10b99d60d/charges/11ec0537-5a7b-26e8-8f44-1738907ed7af/customs \
--header 'Authorization: Bearer {secret}.{jwt}' \
--header 'content-type: application/json' \
--data '{
  "declaration": {
    "customs": "HANGZHOU_ZS",
    "merchant_customs_no": "123456",
    "certificate_id": "330821198809085211",
    "certificate_name": "Zhang San"
  }
}'

Response

Code: 201

Header:

Content-Type: application/json

Body:

{
  "id": "32252e5f-1e76-4c68-8bc9-1b4e00bd7ea4",
  "charge_id": "11ec0537-5a7b-26e8-8f44-1738907ed7af",
  "merchant_id": "11ec0537-59f8-cb4e-8f44-dffabef7e67c",
  "store_id": "11ec0537-5a17-7490-8f44-97e10b99d60d",
  "mode": "live",
  "gateway": "we_chat_online",
  "declaration": {
    "customs": "HANGZHOU_ZS",
    "merchant_customs_no": "123456",
    "certificate_id": "330821198809085211",
    "certificate_name": "Zhang San"
  },
  "declaration_result": {},
  "status": "pending",
  "error": null,
  "created_on": "2021-08-25T09:01:37.917677+09:00"
}