连连开放平台文档

海关推送申请

POST/v1/cbpayment/apply-pushpay

重要返回码：0000 受理成功，9901 一码多义

请求参数

timestamp

string

时间戳

必需

交易服务器时间戳格式：yyyyMMddHHmmss 有效期30分钟（包含服务器之间的时间差）

mch_id

string

商户号

必需

平台商户的唯一编号

user_name

string

用户名称

必需

用户名称

id_type

string

证件类型

必需

用户证件类型
身份证 IDCARD
其他 OTHER

id_no

string

证件号码

必需

证件号码

phone

string

手机号

可选

用户手机号

txn_seqno

string

推送商品单号

必需

商户报送唯一商品单号

org_txn_seqno

string

商户支付单号

必需

商户系统交易支付单号

txn_time

string

商户支付交易时间

必需

商户系统支付交易时间
格式：yyyyMMddHHmmss

operate_type

string

操作类型

可选

ADD-新增 MOD-变更，默认ADD-新增

total_amount

number

订单总金额

必需

订单总金额,单位元

platform_code

string

电商平台代码

必需

电商平台代码

platform_name

string

电商平台名称

必需

电商平台的海关注册登记名称

custom_code

string

海关编码

必需

参见‘海关编码’

notify_url

string

异步通知地址

必需

交易结果异步通知接收地址，建议HTTPS协议

sub_order_flag

string

拆单标识

可选

拆单场景下，送固定值Y，标识该笔支付单需要拆单推送
不涉及拆单，不传该字段

pay_fee_amount

number

物流费

可选

单位元，没有物流费时默认为0元

pay_gds_amt

number

商品价格

必需

单位元

pay_tax_amt

number

税款

可选

税款(单位元)
单位元，没有税款时默认为0元

extend_info

string

扩展字段

可选

海关需要的额外参数，JSONString

auth_check_strategy

string

推送校验策略

可选

DIFF_PUSH 不同继续推送 DIFF_REJECT 不同推单拒绝

{
  "timestamp": "string",
  "mch_id": "string",
  "user_name": "string",
  "id_type": "string",
  "id_no": "string",
  "phone": "string",
  "txn_seqno": "string",
  "org_txn_seqno": "string",
  "txn_time": "string",
  "operate_type": "string",
  "total_amount": 0,
  "platform_code": "string",
  "platform_name": "string",
  "custom_code": "string",
  "notify_url": "string",
  "sub_order_flag": "string",
  "pay_fee_amount": 0,
  "pay_gds_amt": 0,
  "pay_tax_amt": 0,
  "extend_info": "string",
  "auth_check_strategy": "string"
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

ret_code

string

交易结果代码

必需

交易返回码

ret_msg

string

交易结果描述

必需

交易返回描述

mch_id

string

商户号

必需

ACCP系统分配给平台商户的唯一编号

txn_seqno

string

推送商品单号

必需

商户报送唯一商品单号

accp_txno

string

ACCP推送单号

必需

ACCP推送单号

org_txn_seqno

string

商户支付单号

必需

商户系统交易支付单号

push_status

string

推送状态

必需

参见‘推送订单状态’

pay_company_code

string

支付企业代码

必需

pay_company_name

string

支付企业名称

必需

pay_transaction_id

string

支付交易编号

必需

非拆单场景下，值为accp内部支付单号
拆单场景下，值为hash(accp内部支付单号+推送商品单号)

push_date

string

推送日期

可选

推送日期格式yyyyMMdd

push_failReason

string

推送失败原因

可选

推送失败时会有

result_info

string

结果信息

可选

JSON格式字符串
user_check_result 用户信息校验结果，值为SAME 一样DIFF 不一样

{
  "ret_code": "string",
  "ret_msg": "string",
  "mch_id": "string",
  "txn_seqno": "string",
  "accp_txno": "string",
  "org_txn_seqno": "string",
  "push_status": "string",
  "pay_company_code": "string",
  "pay_company_name": "string",
  "pay_transaction_id": "string",
  "push_date": "string",
  "push_failReason": "string",
  "result_info": "string"
}