支付成功回传接口

基本信息

接口名称
请求方式 Post application/x-www-form-urlencoded
功能描述 菜鸟速递在运单运费完成支付后将支付信息回传给外部商家
编码 UTF-8

入参

项目 名称 类型 必填 描述 备注
对接码 logistic_provider_id String 是 菜鸟侧提供
签名 data_digest String 是 Base64(Md5(logistics_interface+双方约定的secretKey)) ,0.2 签名方法 x-www-form-urlencoded格式可能会出现加号变空格的情况，发请求之前可以对签名进行urlencode
业务报文 logistics_interface String 是 JSON

logistics_interface内容

项目 名称 类型 必填 描述 示例
运单号 mailNo String 是 运单号 621000153894
费用项编码 feeCode String 是 费用项编码 normal_delivery_fee
费用项名称 feeName String 是 费用项名称 正向配送费
金额 amount String 是 金额（元） 7.2
支付成功时间 paySucceedTime String 是 支付成功时间 2023-07-12 18:23:02
账单ID chargeBillId String 是 账单ID 111111
同一运单不同费用项（如正向配送费和保价费）会分两次回传，同一运单号同一费用项只有一条记录，可按照mailNo+feeCode幂等

出参

项目 名称 类型 必填 描述 备注
成功标识 success Boolean 是
错误码 errorCode String 否
错误说明 errorMsg String 否

示例报文

请求： 仅供参考，实际测试账号需联系菜鸟速递开发提供 logistic_provider_id: edi_test_json

logistics_interface: {"mailNo":"621000153894","feeCode":"normal_delivery_fee","feeName":"正向配送费","amount":"7.2","paySucceedTime":"2023-07-12 18:23:02","chargeBillId":"111111"}

data_digest: 4HQeJTYreTvD57k8tU8xCQ==

返回：

{"success":true}

附录

费用项说明

费用项名称 费用项code 触发计费的实操节点
（不保证该节点后会立即触发计费）		 备注
正向配送费 normal_delivery_fee CHECK_BILL-揽收核重
保价费 insurance_fee 同正向配送费
大促及峰期服务附加费 dcjgfqfwfjf 同正向配送费
逆向-承诺拦截费 nxcnljf_fee TMS_CUT_SUCCESS-实物拦截成功
逆向-拒收退回费 nxjsth_fee SiteAuditDeliveryReject-拒收
服务赔付 compensate_service 菜鸟向商家支付服务赔付费用 值是负的
货值赔付 compensate_item 菜鸟向商家支付货值赔付费用 值是负的