报关接口

目前只针对支付成功的订单进行报关,报关金额为订单金额,customs_code 是海关编号字段说明,trade_no 区别于 Charge 中的 order_no ,两者不能相同。注意:

1 - 此接口不支持 Test 模式下调用,仅可在 Live 模式下调用;

2 - 当使用支付宝报关时:新郑综合保税区(空港)、深圳海关两地的支付单需要同时报往地方平台和总署:

2.1 - 不拆单,即 is_split=false 时:①先推送属地,再使用新的 trade_no 推送总署;②同一笔订单的两次推送,除了 customs_codetrade_no 变更外,其他请求字段不变,以免国检请求失败;

2.2 - 拆单,即 is_split=true 时:①先推送属地,5 分钟后再使用同一个 trade_no 推送总署;②同一笔订单的两次推送,除了 customs_code 变更外,其他请求字段不变,以免国检请求失败;

属性描述
id string报关对象 id
app string应用 ID,查看如何获取App ID
channel string报关使用的第三方支付渠道。取值范围:1:支付宝类(alipayalipay_pc_directalipay_wapalipay_qrcb_alipaycb_alipay_wapcb_alipay_pc_direct),2:微信类(wxwx_pubwx_pub_qrwx_wapcb_wxcb_wx_pubcb_wx_pub_qrcb_wx_pub_scan),3:银联类(upacpupacp_wapupacp_pcapplepay_upacp)。
trade_no string商户报关订单号,8~20位。
customs_code string海关编号,详情请参照海关编号说明
amount int报关金额,取值范围:1~1000000000。
charge stringcharge 对象 id
transport_amount int订单物流金额,默认为0,当 is_splittrue 时,此参数无效。
is_split boolean是否拆单,默认值为"false"。
sub_order_no string商户子订单号,1~30位,当 is_splittrue 时此参数必填。
extra map自定义参数,如果渠道为银联则需要额外参数 extra ,详情请参考下方 extra 参数说明
object string值为 "customs" 。
created timestamp创建时间,用 Unix 时间戳表示。
time_succeeded int处理时间,用 Unix 时间戳表示。
status string报关状态,pending: 处理中; succeeded: 成功; failed: 失败 。
failure_code string错误码,详见 错误 中的错误码描述。
failure_msg string错误信息描述。
transaction_no string渠道报关流水号。
extra 参数
pay_account string支付ID,1~60位,字母、数字和/或特殊符号字符。
certif_type string证件类型,取值范围参考:"01":身份证;"02":军官证;"03":护照;"04":回乡证;"05":台胞证;"06":警官证 "07":士兵证; "99":其它证件。
customer_name string姓名,1~20位,字母、数字和/或特殊符号字符。
certif_id string证件号,1~30位,字母、数字和/或特殊符号字符。
tax_amount int税费的金额。

示例对象

{
    "id": "14201607013878045463",
    "object": "customs",
    "app": "app_LibTW1n1SOq9Pin1",
    "charge_id": "ch_L8qn10mLmr1GS8e5OODmHaL4",
    "channel": "upacp",
    "trade_no": "15112496832609",
    "customs_code": "GUANGZHOU",
    "amount": 100,
    "status": "pending",
    "created": 1410834527,
    "time_succeeded": 1410838127,
    "failure_code": null,
    "failure_msg": null,
    "transaction_no": "xxxxxxxx",
    "extra":{}
}