聚合正扫

针对目前常见的二维码支付(微信/支付宝/银联云闪付),提供聚合后的扫码支付接口,从扫码支付形式的不同分为聚合正扫和聚合反扫。

请求参数

  • 请求地址

https://spin.cloudpnr.com/top/trans/pullPayInfo

  • 公共请求参数

请求报文头HEADER - 「接口规则-参数规定-报文头」 ,请求报文体BODY - 「接口规则-参数规定-报文体」 ,响应报文体 - 「接口规则-参数规定-响应报文体」

  • 请求参数(data)
参数 中文名 类型 必填 最大长度 说明
req_seq_id 请求流水号 String Y 128 请求流水号,请求日期 + 请求流水号需保证唯一
req_date 请求时间 String Y 8 请求时间YYYYMMDD
mer_ord_id 商户订单号 String Y 128 同一个product_id及huifu_id下需唯一
huifu_id 商户号 String Y 16  
trade_type 交易类型 String Y 16 微信公众号:T_JSAPI;小程序:T_MINIAPP; 支付宝JS:A_JSAPI;支付宝正扫:A_NATIVE; 银联正扫:U_NATIVE;银联JS:U_JSAPI;数字人民币二维码支付:D_NATIVE;
bank_channel_no 渠道号 String N 32 渠道号,若需使用自有渠道请联系业务对接人;不传走默认线下
trans_amt 交易金额 String Y 12 交易金额
goods_desc 商品描述 String Y 127  
terminal_device_info 设备信息 JSON N 1024 Json对象,详见 设备信息
risk_check_info 风控信息 String Y 4000 风控信息,jsonObject字符串,详见 风控信息
notify_url 异步通知地址 String Y 512 异步通知地址,支持VIRGO方式。virgo://#{http_server_url} 例:virgo://http://www.xxx.com/getResp
time_expire 交易有效期 String N 14 非必填,订单失效时间,超过此时间限制之后该笔订单将无法进行支付,失效时间与订单创建时间之间的间隔应大于60S,YYYYMMDDHHMMSS格式;
limit_pay 指定支付方式 String N 1 是否禁止用户使用信用卡支付。默认不禁用,若禁止请填1
is_delay_acct 延时标记 String N 1 是否延时交易,1为延迟 0为不延迟
term_div_coupon_type 传入分帐遇到优惠的处理规则 int N   1-按比例分 2-按顺序保障 3-只给交易商户(默认) 参考附录 传入分帐遇到优惠的处理规则
acct_split_bunch 分账串 JSON N 4000 4000位,见附录 请求分账串
mer_priv 商户私有域 String N 1024 原样返回
wx_data 微信扩展参数集合 JSON N   Json格式,见附录 微信请求参数
alipay_data 支付宝扩展参数集合 JSON N   Json格式,见附录 支付宝请求参数
unionpay_data 银联扩展参数集合 JSON N   Json格式,见附录 银联请求参数
pay_scene 手续费类型 String N   01:标准费率线上,02:标准费率线下,03:非盈利费率,04:缴费费率,05:保险费率,06:行业活动费率,07:校园餐饮费率,08:K12中小幼费率
fq_mer_discount_flag 分期贴息类型 int N   分期贴息类型,1:商户贴息,默认商户不贴息。注意:当此处填1时,花呗商户承担比例hb_fq_seller_percent只能填0
remark 交易备注 String N 45  
digitalBankNo 数字货币银行编号 String N 5 01002-工行,01003-农行(暂不支持),01004-中行(暂不支持), 01005-建行(暂不支持) 01002-工行,01003-农行(暂不支持),01004-中行(暂不支持), 01005-建行(暂不支持) 01006-网商(暂不支持),01007-微众(暂不支持), 01008-邮储, 01009-交行(暂不支持)

响应参数

  • 同步响应参数(data)
参数 中文名 类型 必填 最大长度 说明
sub_resp_code 业务返回码 String Y 8 见附录 业务返回码
sub_resp_desc 业务返回描述 String Y 512 业务返回描述
req_seq_id 请求流水号 String Y   交易时传入,原样返回
req_date 请求时间 String Y   交易时传入,原样返回
huifu_id 汇付商户号 String Y 32 汇付分配的商户号
mer_ord_id 商户订单号 String Y 50 商户生成
hf_seq_id 汇付流水号 String N 128  
trade_type 交易类型 String Y   见附录 交易类型
trans_amt 交易金额 String Y 12 交易金额
settlement_amt 结算金额 String Y 16 结算金额,实际支付金额
wx_response 微信返回的响应报文 JSON N   以下字段当业务返回码=00时有返回
alipay_response 支付宝返回的响应报文 JSON N   以下字段当业务返回码=00时有返回
unionpay_response 银联返回的响应报文 JSON N   以下字段当业务返回码=00时有返回
trans_stat 交易状态 String N 1 I:初始、P:处理中、S:成功、F:失败
acct_stat 账务状态 String N 1 I:初始、P:处理中、S:成功、F:失败
bank_code 通道返回码 String N 32  
bank_message 通道返回描述 String N 200  
qr_code 二维码链接 String N 64  
pay_info js支付信息 String N 500 json 格式,作用于JS支付时的参数(对于JS支付会返还),用于前端唤起微信或支付宝的支付控件
token_id 动态口令 String N 64 I授权口令
is_delay_acct 是否延时交易 String N 1 1:延时交易 ; 0:非延时交易;
mer_priv 商户私有域 String N 1024 原样返回
dc_response 数字货币返回响应参数 String N   以下字段当业务返回码=00时有返回,数字货币内容
  • 异步响应参数(resp_data)
参数 中文名 类型 必填 最大长度 说明
sub_resp_code 业务返回码 String Y 8 见附录 业务返回码
sub_resp_desc 业务返回描述 String Y 512 业务返回描述
req_seq_id 请求流水号 String Y   交易时传入,原样返回
req_date 请求时间 String Y   交易时传入,原样返回
huifu_id 汇付子商户号 String Y 16 汇付分配的商户号
mer_ord_id 商户订单号 String Y 128 商户生成
hf_seq_id 汇付流水号 String N 128  
trans_type 交易类型 String Y   见附录 交易类型
trans_amt 交易金额 String Y 12 交易金额
settlement_amt 结算金额 String Y 16 结算金额
wx_response 微信返回的响应报文 JSON N   微信异步报文内容
alipay_response 支付宝返回的响应报文 JSON N   支付宝异步报文内容
unionpay_response 银联返回的响应报文 JSON N   银联异步报文内容
acct_split_bunch 分账串 JSON N 4000 见附录 返回分账串
is_delay_acct 是否延时交易 String N 1 1:延时交易 ; 0:非延时交易;
is_div 是否分账交易 String N 1 1:分账交易 ; 0:非分账交易;
acct_date 账务日期 String Y 8 ACCT账务日期,yyyyMMdd
fee_amount 手续费金额 String Y 16 手续费金额
fee_flag 手续费扣款标志 int Y   1:外扣; 2:内扣
notify_type 通知类型 int Y   1:通道通知,2:账务通知
trans_stat 交易状态 String N 1 I:初始、P:处理中、S:成功、F:失败
acct_stat 账务状态 String N 1 I:初始、P:处理中、S:成功、F:失败
bank_code 通道返回码 String N 32  
bank_message 通道返回描述 String N 200  
out_trans_id 微信支付宝订单号 String N 64  
party_order_id 支付凭证号 String N 64  
end_time 支付完成时间 String N 14 支付完成时间,格式为yyyyMMddHHmmss,如2009年12月25日 9点10分10秒表示为20091225091010
debit_flag 借贷标识 String N 1 见附录 借贷标识
trans_time 交易时间 String N 14 支付完成时间,格式为yyyyMMddHHmmss
out_ord_id 外部订单号 String N 50  
devs_id 汇付终端号 String N 32  
posp_seq_id 凭证号 String N 6  
remark 备注 String N 45  
mer_priv 商户私有域 String N 1024 原样返回
auth_no 授权码 String N 64  
fq_mer_discount_flag 分期贴息类型 int N   分期贴息类型,1:商户贴息
dc_response 数字货币返回响应参数 String N   以下字段当业务返回码=00时有返回, 数字货币内容
wx_user_id 微信用户唯一标识码 String N 128 微信用户唯一标识码;259号文新增字段
mer_dev_location 商户终端定位 jsonObject N   Json格式 ;详见 259号文新增字段

请求示例

{
    "sign_type":"RSA2",
    "sys_id":"ACWILL",
    "sign": "kP0YeT3BxIRpc0SsrCLRh6ZCKDk/nvJhCCIHb4MSuJacEvkeK8H7QPG+uGegrC92HWtHxFYeoh2csH4sy7IQG9EC1Dh0aKC+r5j/GXb014ZqQBksVMtsSXJpe5JcbMIHfLgdgfWn3SvMsI8Co2BxseC6mC4VQHZDcAc0upoJwqhpsibzm1d+dFVKkLUL5veO1uNhXhPdYx6VSQJbj9MFCh5Vrkf1yc/lvLqGLm5E1ZJjHovMJLNrIBodGkKXO8vB7JtWoTqDN+0eVZFjp9nVO1b7F3CtMABarcpw+v13FjOMAmpkF1ZiYOaHFvHGIaWCVbOvLn2dVXQZsWTCwQvWmA==",
    "data": "{\"devs_id\":\"SPINTP320939500790581\",\"goods_desc\":\"测试商品\",\"huifu_id\":\"6666000101234567\",\"mer_ord_id\":\"20210322242839189460627456W\",\"notify_url\":\"virgo://http://xxx.com/callback\",\"product_id\":\"test\",\"req_date\":\"20210322\",\"req_seq_id\":\"page01242839207519723520\",\"risk_check_info\":\"{\\"riskMngInfo\\":{\\"subTradeType\\":\\"4300\\"},\\"ipAddr\\":\\"139.207.19.246\\"}\",\"sub_openid\":\"oJVd2uA7J6yQvx-tUP_xz\",\"terminal_device_info\":{\"device_ip\":\"139.207.19.246\",\"device_type\":\"1\",\"devs_id\":\"SPINTP320939500790581\"},\"time_expire\":\"20210322172803\",\"trade_type\":\"T_JSAPI\",\"trans_amt\":\"9.00\",\"wx_data\":{\"openid\":\"oJVd2uA7J6yQvx-tUP_jSydcX0zA\",\"sub_appid\":\"wxec280d4c8a1cc2ca\"}}"
}

响应示例

{
    "resp_code":"10000",
    "resp_desc":"成功调用",
    "data":"{\"acctStat\":\"I\",\"bank_code\":\"SUCCESS\",\"bank_message\":\"成功\",\"hf_seq_id\":\"002900TOP2A210322172603P866ac132fcd00000\",\"huifu_id\":\"6666000101234567\",\"mer_ord_id\":\"20210322242839189460627456W\",\"payInfo\":\"{\\"appId\\":\\"xxxx\\",\\"timeStamp\\":\\"1616405164\\",\\"nonceStr\\":\\"825c00cef333490a804b192086f90b3b\\",\\"package\\":\\"prepay_id=wx22172604180910e4495d56c49e00210000\\",\\"signType\\":\\"RSA\\",\\"paySign\\":\\"vB5F1hCmTraUqdMXnIrsIoYVKX3xrAFQ0l2uE8KM6cuiaZV/9XcMoEd+s40vW2KHtsamtGouLVQEPeNUnkxV/PEP70cthvKTqb7Bcuqi6wgGjRNKYIVveVSGqIh86UO5zcRWCwYsO982Pc3lQDFtXCmqIn6LaYjayGZbsNg55Zy2Gp1DCUD+STwGsTJJgeI15vAAO3IHJuC4POVehh/pVB9mkMAVptByZ/LyMkOWySUE2Vkvp/W+e24ntCAFBHXlWrhgkNtBesOSBvZ04gTwbSCFeavbDO1lF8ABXhLlBY7JKojYhYwJEibm7QIZgXGNhoFqoYSBkJYfdT9wAbkRBA==\\"}\",\"product_id\":\"test\",\"req_date\":\"20210322\",\"req_seq_id\":\"page01242839207519723520\",\"settlement_amt\":\"9.00\",\"sub_resp_code\":\"00000100\",\"sub_resp_desc\":\"交易正在处理中 cashCode:000 cashDesc:成功\",\"trade_type\":\"T_JSAPI\",\"trans_amt\":\"9.00\",\"trans_stat\":\"P\",\"wx_response\":{\"payInfo\":\"{\\"appId\\":\\"xxxx\\",\\"timeStamp\\":\\"1616405164\\",\\"nonceStr\\":\\"825c00cef333490a804b192086f90b3b\\",\\"package\\":\\"prepay_id=wx22172604180910e4495d56c49e00210000\\",\\"signType\\":\\"RSA\\",\\"paySign\\":\\"vB5F1hCmTraUqdMXnIrsIoYVKX3xrAFQ0l2uE8KM6cuiaZV/9XcMoEd+s40vW2KHtsamtGouLVQEPeNUnkxV/PEP70cthvKTqb7Bcuqi6wgGjRNKYIVveVSGqIh86UO5zcRWCwYsO982Pc3lQDFtXCmqIn6LaYjayGZbsNg55Zy2Gp1DCUD+STwGsTJJgeI15vAAO3IHJuC4POVehh/pVB9mkMAVptByZ/LyMkOWySUE2Vkvp/W+e24ntCAFBHXlWrhgkNtBesOSBvZ04gTwbSCFeavbDO1lF8ABXhLlBY7JKojYhYwJEibm7QIZgXGNhoFqoYSBkJYfdT9wAbkRBA==\\"}\",\"resultCode\":\"SUCCESS\"}}",
    "sign":"ixo6gYmN3+OqWxPOg9HG/CoyTzsyASWxPAW1eQEtHvUEx4VrXbc+rjwYBQ3qmAwe3xEurD4Y8YnpgOl7f7fCD71GyNuUDdK92goZ58FFbj11RU+WYjfee75AAk3H/C3eew8iJvyyTp924AFunyt5t30x9bLF1GF9l43ztuBV9ttYirJ2mjc67NWxOlbFrTwfeTn4HA5GhL4WeN3yd+RH7kzbbMQkqps9tM52zCdrJmVyht1LwIFMqKAvA5/cZvDOZzYr3T0ErrYQZLIcKP3oEIKUYKhFmKe2q8s38ybf8Ih9drDAkRpLLyGwnb1RRZ1rO45JdU1uG+VZ29g3jqTTxg=="
}
  • 接口调用实例

Demo参考