2.2 海关申报修改接口
- 请求地址：https://pay.bilibili.com/payplatform/pay/v2/declare/customModifyDeclareOrder
- 使用必读
- 1.因为需要调用第三方，耗时未知，至少设置为3s
- 2.amount、subTransportFee、subProductFee任何一个修改必须同时修改
- 请求方式： http post application/json
入参列表
以下参数除sign外全部参与签名
| 请求参数 | 描述 | 类型 | 是否必须传入 |
|---|---|---|---|
| customerId | 支付平台分配给开发者的业务id | Int | 是 |
| outDeclareNo | 业务方申报单号，业务方需要保证唯一 | string(32) | 是 |
| txId | 支付流水号 | string(32) | 是 |
| customsPlace | 海关 NINGBO (宁波) | string(32) | 否 |
| mchCustomsNo | 商户海关备案号 | string(32) | 否 |
| mchCustomsName | 商户海关备案名称 | string(64) | 否 |
| amount | 报关金额，单位分 如有拆单 amount = subTransportFee+subProductFee | Int | 否 |
| duty | 商户海关备案号 | Int | 否 |
| subTransportFee | 物流费用，以分为单位，如有拆单则必传。 | Int | 否 |
| subProductFee | 商品费用，以分为单位，如有拆单则必传。 | Int | 否 |
| traceId | 请求标识id | string | 是 |
| version | 接口版本，目前1.0 | string | 是 |
| timestamp | 当前时间戳,毫秒 | long | 是 |
| signType | 签名校验类型，默认MD5 | string | 是 |
| sign | 校验签名 | string | 是 |
返回列表
【errno及msg映射】
| errno | Msg |
|---|---|
| 0 | Success |
| 8004010001 | outDeclareNo已存在 |
| 8004010002 | 不支持此海关 |
【data返回体】
| 返回字段 | 描述 |
|---|---|
| txId | 支付流水号 |
| status | 申报状态 UNDECLARED -- 未申报（暂未提交到第三方） PROCESSING -- 申报中 SUCCESS -- 申报成功 FAIL-- 申报失败 |
| outDeclareNo | 支付平台分配给开发者的业务id |
| orderId | 业务方申报单号 |
| certCheckResult | 身份信息校验结果 UNCHECKED 商户未上传订购人身份信息 SAME 商户上传的订购人身份信息与支付人身份信息一致 DIFFERENT 商户上传的订购人身份信息与支付人身份信息不一致 |
| initalRequest | 向第三方支付企业发送的申报信息 |
| initalResponse | 第三方支付企业返回的结果 |
| channelOrderNo | 第三方支付企业的支付流水号 |
| recpAccount | 收款账户 |
| recpName | 收款企业名称 |
返回示例
{
"errno": 0,
"msg": "success",
"data": {
"txId": "3063660176692617216",
"outDeclareNo": "1212376692617216",
"status": "UNDECLARED",
"certCheckResult": "UNCHECKED",
"initalRequest": "",
"initalResponse": "",
"channelOrderNo": "2017081721001004570217155618",
"recpAccount": "2017081721001004570217155618",
"recpName": "2017081721001004570217155618",
}
}