二维码支付
1、修订记录
修订 |
日期 |
说明 |
作者 |
1 |
2016/08/11 |
新接口参数定义 |
郭勇 |
2 |
2021/08/10 |
删除 cross_border_info |
|
3 |
2021/10/19 |
删除 province、city |
|
4 |
2021/12/27 |
支持国密 |
王晶 |
5 |
2021/12/28 |
新增支付宝上送门店信息参数(store_id,alipay_store_id,operator_id、terminal_id) |
林竞 |
6 |
2022/01/25 |
limit_credit_pay 新增花呗相关操作值:2禁用花呗,3禁用花呗分期,4禁用所有信用支付类型 |
刘雷 |
7 |
2022/02/17 |
seller_name修改为非必填 |
王晶 |
8 |
2022/03/17 |
version为3.9时 新增支付成功异步通知营销相关字段 |
刘雷 |
9 |
2022/03/18 |
新增银联259号文条码改造相关字段 |
刘雷 |
10 |
2022/03/22 |
新增是否返回https协议图片url字段 |
康少雄 |
11 |
2022/07/05 |
新增实名认证信息 |
刘雷 |
12 |
2022/10/19 |
对异步通知的coupon_info字段的参数说明进行调整 |
刘军 |
13 |
2022/12/14 |
新增支付宝业务拓展参数extend_params_channel |
刘军 |
14 |
2023/01/09 |
新增花呗分期期数支持3期,新增分期类型fq_type |
林竞 |
15 |
2023/01/09 |
新增同步响应参数发往渠道流水号channel_send_sn |
林竞 |
16 |
2023/4/13 |
新增请求参数服务商信息编号corp_src_superieor |
方立 |
2、业务说明
(1)场景说明
1、商户后台系统先调用银盛支付下单接口,银盛后台系统返回链接参数二维码,
2、商户后台系统将链接值生成二维码图片,用户使用app客户端扫码后发起支付。
(2)接口说明
1、商户后台系统根据用户选购的商品生成订单
2、用户确认后,商户调用银盛支付二维码支付生成预支付交易
3、银盛支付收到请求后生成交易订单,并返回交易二维码链接
4、商户后台系统根据返回的链接生成二维码
5、用户打开APP扫描二维码,客户端扫码并唤起支付控件
3、请求地址
4、请求参数说明
4.1 公共请求参数
参数 |
类型(字节长度) |
必填 |
参数说明 |
method |
String(128) |
Y |
接口名称 固定值ysepay.online.qrcodepay |
partner_id |
String(20) |
Y |
在银盛支付开设的服务商商户号,请联系客户经理提供 |
timestamp |
String(19) |
Y |
发送请求的时间,格式"yyyy-MM-dd HH:mm:ss" 2014-07-24 03:07:50 |
charset |
String(10) |
Y |
商户网站使用的编码格式,如UTF-8、GBK、GB2312等,默认值 GBK |
sign_type |
String(10) |
Y |
报文签名算法,RSA 、SM |
sign |
String(256) |
Y |
签名字符串,再用Base64编码 |
notify_url |
String(500) |
Y |
交易成功异步通知到商户的后台地址,http路径支持多个url进行异步通知,多个url用分隔符“,”分开,格式如:url1,url2,url3,支持TLS1.0、TLS1.1、TLS1.2 |
version |
String(3) |
Y |
版本号3.0/3.4/3.5 当前版本3.5 |
return_url |
String(190) |
N |
(前台跳转)同步通知地址 |
tran_type |
String(1) |
N |
交易类型,说明:1或者空:非担保交易,2:担保交易,无特殊需求 不用填此字段 |
biz_content |
String |
Y |
业务请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递 |
4.2 业务请求参数
参数名biz_content,值为一个json格式对象,下面列表描述json对象的值
参数 |
类型(字节长度) |
必填 |
参数说明 |
out_trade_no |
String(1,32) |
Y |
商户系统生成的订单号,须保证在商户端不重复,生成规则前8位必须为交易日期,如20220525,范围跨度支持包含当天在内的前后一天,且只能由大小写英文字母、数字、下划线及横杠组成,示例值:202205256843192280647118 |
shopdate |
String(8,8) |
Y |
商户系统的交易发生日期格式yyyyMMdd例示例值 20180525 |
subject |
String(1,250) |
Y |
订单备注 |
total_amount |
Number(10,2) |
Y |
该笔订单的资金总额,单位为RMB-Yuan。取值范围为[0.01,100000000.00],精确到小数点后两位。Number(10,2)指10位长度,2位精度 示例值100 |
currency |
String(3) |
N |
默认CNY(人民币) |
seller_id |
String(1,20) |
Y |
收款商户号(由银盛支付生成并下发) |
seller_name |
String(1,50) |
N |
收款商户号对应商户名称 |
timeout_express |
String(2,6) |
Y |
设置未付款交易的超时时间,一旦超时,该笔交易就会自动被关闭,取值范围:1m~15d。m-分钟,h-小时,d-天。该参数数值不接受小数点,如1.5h,可转换为90m。注意:设置了未付款交易超时时间的情况下,若我司在限定时间内没有收到成功支付通知,则会关闭交易,关闭后该笔交易若付款方支付成功的情况下,会自动原路退款至付款方。示例值 96h 代表96小时后订单自动关闭 |
business_code |
String(1,10) |
Y |
业务代码 ,请联系银盛客户经理获取。注意:业务代码非固定值,不同到账方式需要传不同的业务代码 |
bank_type |
String(7,9) |
Y |
二维码行别,支付宝:1903000,QQ扫码:1904000,银联扫码:9001002,招商银行:3085840 |
extend_params |
String(500) |
N |
业务扩展参数,一个json字符串,order_mode订单模式,暂时可选的值为:00 代表购物车模式;seller_list参与分账的收款方信息数组,每个元素包含seller_id收款方银盛支付用户号。实时分账业务,order_mode和seller_list均不能为空,order_mode的值必须为00。示例值:样例8.1 |
extra_common_param |
String(2000) |
N |
公用回传参数 商户自定义数据域,原样返回 |
sub_merchant |
SubMerchantInfo |
N |
二级商户信息, Json格式 参考样例,暂包括merName、merShortName、merAddr、telephone、merNo、category、mrchntCertId ,如果有值则二级商户信息都不能为空,如果没值则都不能有值 示例值:附录8.2 |
consignee_info |
ConsigeeInfo |
N |
收货人信息json格式 示例值:附录8.3 |
limit_credit_pay |
String(2) |
N |
是否限制信用卡。值为1表示禁用信用卡,0或为空表示不限制,2禁用花呗,3禁用花呗分期,4禁用所有信用支付类型 |
hb_fq_num |
String(2) |
N |
花呗分期期数,仅在支付宝支付的时候生效,目前期数支持3,6,12 例 6 |
fq_type |
String(2) |
N |
分期类型,值为00表示花呗分期,值01表示信用卡分期。不填默认为花呗分期 |
aliGoodsDetails |
List |
N |
支付宝营销单品详情列表 |
submer_ip |
String(16) |
N |
子商户ip 示例值:112.112.112.112 |
store_id |
String(32) |
N |
商户门店编号 |
alipay_store_id |
String(32) |
N |
支付宝的店铺编号 |
operator_id |
String(28) |
N |
商户操作员编号 |
terminal_id |
String(32) |
N |
商户机具终端编号 |
union_qrcode_259_params |
UnionQrCodeBaseRequest |
N |
银联259号文条码改造字段,json格式 |
need_https_url |
String(1) |
N |
是否需要返回https协议图片url,Y是/N否/空 |
buyer_realname_info |
buyer_realname_info |
N |
实名认证信息 :有证件类型、证件姓名、证件号,非必填,如果三个字段一个填写就都必填,要么就都不上送 |
extend_params_channel |
String |
N |
支付宝业务拓展参数json格式 示例值:样例8.5 |
corp_src_superieor |
String |
N |
服务商信息编号 |
4.3 二级商户 SubMerchantInfo
参数 |
类型(字节长度) |
必填 |
参数说明 |
merName |
String(50) |
N |
二级商户名称,支持25个中文 |
merShortName |
String(50) |
N |
二级商户简称,支持25个中文 |
merAddr |
String(200) |
N |
二级商户地址,支持100个中文 |
telephone |
String(13) |
N |
固定电话/手机号码二选一 |
merNo |
String(32) |
N |
二级商户编号 |
category |
String(20) |
N |
类目,按附件内容输入类目编号 |
mrchntCertId |
String(15\ |
18) |
N |
身份证号,只支持身份证格式(如果签名方式为RSA,则用DES加密,密钥为商户号前8位,不足8位在商户号前补空格;如果签名方式为SM,则用SM加密) |
4.4 收货人信息 ConsigeeInfo
参数 |
类型(字节长度) |
必填 |
参数说明 |
consigneeName |
String(150) |
N |
收货人姓名 |
consigneeAddr |
String(200) |
N |
收货地址 |
transportationInfo |
String(200) |
N |
物流配送信息(物流名称+订单号) |
commodityName |
String(150) |
N |
商品名称 |
commodityNumber |
String(10) |
N |
商品数量, |
4.5 支付宝营销 AliGoodsDetail
参数 |
类型(字节长度) |
必填 |
参数说明 |
goods_id |
String(32) |
Y |
营销单品编号 |
alipay_goods_id |
String(32) |
N |
营销单品支付宝侧编号 |
goods_name |
String(256) |
Y |
营销单品名称 |
quantity |
String(10) |
Y |
营销单品数量,不超过10位的正整数 |
price |
String(12) |
Y |
营销单品单价[0,999999999] 左闭右闭区间,小数点后最多允许两位 |
goods_category |
String(24) |
N |
营销单品类目 |
categories_tree |
String(128) |
N |
营销单品类目树 |
body |
String(1000) |
N |
营销单品描述 |
show_url |
String(400) |
N |
营销单品展示地址 |
4.6 银联259号文条码改造字段 UnionQrCodeBaseRequest
参数 |
类型(字节长度) |
必填 |
参数说明 |
terminal_no |
String(8) |
Y |
终端号,收单机构为商户终端分配的唯一编号 |
terminal_type |
String(2) |
Y |
终端类型(线下交易场景必填):01 自动柜员机(含 ATM 和 CDM)和多媒体自助终端、02 传统 POS、03 mPOS、04 智能 POS、05 II 型固定电话、06 云闪付终端、07 保留使用、08 手机 POS、09 刷脸付终端、10 条码支付受理终端、11 辅助受理终端、12 行业终端(公交、地铁用于指定行业的终端)、13 MIS 终端 |
serial_num |
String(50) |
O |
终端序列号,备注:终端类型为 02;03;04;05;06;08;09或10时,必须填写终端序列号 |
network_license |
String(5) |
N |
银行卡受理终端产品入网认证编号,备注:终端类型为 02;03;04;05;06;08;09或10时,终端设备如果有相关参数,建议填写 |
app_version |
String(5) |
N |
终端应用程序的版本号,备注:终端类型为 02;03;04;05;06;08;09或10时,建议填写。终端应用程序的版本号,应用程序变更应保证版本号不重复。 |
terminal_gps |
String(32) |
O |
交易设备位置信息,格式:纬度/经度,东经为正数,西经为负数;北纬为正数,南纬为负数,线下交易场景、terminal_ip和terminal_gps 二者选其一 必填 |
terminal_ip |
String(8) |
O |
商户端终端设备 IP 地址。注:如经、维度信息未上送,该字段必送。 |
encryp_rand_num |
String(10) |
N |
加密随机因子 |
secret_text |
String(16) |
N |
密文数据 |
4.7 实名认证信息 buyer_realname_info
参数 |
类型(字节长度) |
必填 |
参数说明 |
id_no |
String |
Y |
证件号,只支持身份证格式(如果签名方式为RSA,则用DES加密,密钥为商户号前8位,不足8位在商户号前补空格;如果签名方式为SM,则用SM加密) |
id_type |
String |
Y |
证件类型,只支持身份证,枚举值:1 |
id_name |
String |
Y |
证件姓名 |
5、响应参数说明
银盛支付对商户的请求数据处理完成后,会将处理的结果数据同步回执给商户。
请注意:银盛后期会对返回参数保留扩展的权力,扩展方式为新增参数但不会删除参数,请商户在解析银盛返回参数时要支持银盛可能扩展参数这种情况。
5.1 公共响应参数
参数 |
类型(字节长度) |
必填 |
参数说明 |
sign |
String |
Y |
签名字符串,Base64编码 |
ysepay_online_qrcodepay_response |
String |
Y |
业务响应参数的集合,最大长度不限 |
5.2 业务响应参数
参数 |
类型(字节长度) |
必填 |
参数说明 |
code |
String |
Y |
响应代码 |
msg |
String |
Y |
响应代码描述 |
out_trade_no |
String(32) |
Y |
商户系统内部订单号 示例值:6843192280647118 |
trade_no |
String(30) |
N |
银盛支付交易流水号 |
trade_status |
String |
Y |
交易目前所处的状态。成功状态的值: TRADE_SUCCESS示例值:附录9.1 |
qr_code_url |
String(1024) |
Y |
二维码图片地址,示例值:http://qpay.qq.com/qr/0e02ebc4 |
bank_type |
String(7\ |
9) |
Y |
二维码行别 |
source_qr_code_url |
String(1024) |
N |
源二维码地址,此URL用于生成支付二维码,然后提供给用户扫码支付 |
total_amount |
Number |
N |
该笔订单的资金总额,单位为RMB-Yuan。取值范围为[0.01,100000000.00],精确到小数点后两位。例100 |
account_date |
String(19) |
N |
入账日期,(交易对账日期,非结算到银行卡的日期) 格式"yyyy-MM-dd" 例 2014-07-24 |
expire_time |
Number |
N |
过期时间单位分钟 |
extra_common_param |
String(2000) |
N |
商户自定义数据域,原样返回 示例值:123456789 |
channel_send_sn |
String(50) |
N |
发往渠道流水号 |
6、页面跳转同步参数说明
银盛支付对商户的请求数据处理完成后,会将处理的结果数据通过系统程序控制客户端页面自动跳转的方式通知给商户网站。这些处理结果数据就是页面跳转同步通知参数。
请注意:银盛后期会对返回参数保留扩展的权力,扩展方式为新增参数但不会删除参数,请商户在解析银盛返回参数时要支持银盛可能扩展参数这种情况。
参数 |
类型(字节长度) |
必填 |
参数说明 |
sign_type |
String |
Y |
签名类型,请求时的签名类型,RSA/SM |
sign |
String |
Y |
签名字符串,Base64编码 |
notify_type |
String |
N |
通知类型 固定值directpay.status.sync |
notify_time |
String(19) |
Y |
发送请求的时间,格式"yyyy-MM-dd HH:mm:ss" 例 2014-07-24 03:07:50 |
out_trade_no |
String(32) |
Y |
银盛支付合作商户网站唯一订单号。示例值: 6843192280647118 |
trade_status |
String |
Y |
交易目前所处的状态。成功状态的值: TRADE_SUCCESS示例值:附录9.1 |
trade_no |
String(30) |
N |
该交易在银盛支付系统中的交易流水号。 |
extra_common_param |
String(2000) |
N |
公用回传参数 |
total_amount |
Number |
N |
该笔订单的资金总额,单位为RMB-Yuan。取值范围为[0.01,100000000.00],精确到小数点后两位。例 100 |
account_date |
String(19) |
N |
入账日期(交易对账日期,非结算到银行卡的日期),格式"yyyyMMdd" 示例值 20140724 |
7、服务器异步通知参数说明
银盛支付对商户的请求数据处理完成后,会将处理的结果数据通过服务器主动通知的方式通知给商户网站。这些处理结果数据就是服务器异步通知参数。
请注意:银盛后期会对返回参数保留扩展的权力,扩展方式为新增参数但不会删除参数,请商户在解析银盛返回参数时要支持银盛可能扩展参数这种情况。
参数 |
类型(字节长度) |
必填 |
参数说明 |
sign_type |
String |
Y |
签名类型,请求时的签名类型RSA/SM |
sign |
String |
Y |
签名字符串,Base64编码 |
notify_type |
String |
Y |
通知类型 固定值directpay.status.sync |
notify_time |
String(19) |
Y |
发送请求的时间,格式"yyyy-MM-dd HH:mm:ss" 示值例 2014-07-24 03:07:50 |
out_trade_no |
String(32) |
Y |
商户系统内部订单号 示例值6843192280647118 |
total_amount |
Number |
N |
该笔订单的资金总额,单位为RMB-Yuan。取值范围为[0.01,100000000.00],精确到小数点后两位。示例值:100 |
trade_no |
String(30) |
N |
银盛支付交易流水号 |
trade_status |
String |
Y |
交易目前所处的状态。成功状态的值: TRADE_SUCCESS\ |
TRADE_CLOSED 示例值:附录9.1 |
account_date |
String(10) |
N |
入账的时间,格式"yyyyMMdd" 示例值:20140724 |
openid |
String(128) |
N |
子商户appid下用户唯一标识 |
payer_fee |
Number |
N |
该笔订单的付款方手续费(支付用户),单位为RMB-Yuan。取值范围为[0.01,100000000.00],精确到小数点后两位。示例值:1.00 |
payee_fee |
Number |
N |
该笔订单的收款方手续费(收款商户),单位为RMB-Yuan。取值范围为[0.01,100000000.00],精确到小数点后两位。示例值: 1.00 |
partner_fee |
Number |
N |
该笔订单的合作方手续费(服务商户),单位为RMB-Yuan。取值范围为[0.01,100000000.00],精确到小数点后两位。示例值:1.00 |
fee |
Number |
N |
该笔订单的手续费总和(汇总),单位为RMB-Yuan。取值范围为[0.01,100000000.00],精确到小数点后两位。示例值:1.00 |
coupon_info |
String |
N |
JSON字符串,银联营销渠道响应优惠信,version小于3.6版本为List的JSON字符串,3.6版本(含)以上为CouponInfo的JSON字符串 |
settlement_amount |
Number |
N |
结算金额 示例值:100 |
channel_send_sn |
String(50) |
N |
发往渠道流水号 示例值 12345678a |
paygate_no |
String(16) |
N |
支付网关编号 |
channel_recv_sn |
String(50) |
N |
渠道返回流水号 |
buyer_user_id |
String |
N |
支付宝用户Uid |
buyer_logon_id |
String |
N |
该字段于2023-9-1已不支持使用,请使用buyer_id对接,如有疑问请咨询银盛技术支持! |
payer_bank_account_no |
String |
N |
银联云闪付款方账号 |
extra_common_param |
String |
N |
公用回传参数 商户自定义数据域,原样返回 例 123456789 |
alipay_trx_resp_coupon_info |
String |
N |
支付宝优惠信息,版本号3.5及以上支持 |
ali_merchant_amount |
String |
N |
支付宝商家优惠金额,版本号3.5及以上支持 |
ali_platform_dis_amount |
String |
N |
支付宝平台优惠金额,版本号3.5及以上支持 |
ali_goods_details |
String |
N |
支付宝营销单品信息,版本号3.5及以上支持 List的JSON字符串 |
preferential_amount |
Number |
N |
营销优惠金额 版本3.9及以支持 示例值:样例1.2 |
preferential_fee |
Number |
N |
营销优惠手续费 版本3.9及以支持 示例值:样例0.02 |
marketing_rule_json |
String |
N |
营销规则信息json 版本3.9及以支持 |
7.1 响应参数 GoodsDetail
参数 |
类型(字节长度) |
必填 |
参数说明 |
id |
String(64) |
Y |
记录编号,唯一标识 |
tradesn |
String(30) |
Y |
银盛交易流水 |
seq |
Integer(4) |
Y |
银盛交易流水序列号 |
createtime |
Date |
Y |
记录创建时间 |
wxpayGoodsId |
String(32) |
N |
渠道单品标识 |
goodsName |
String(256) |
N |
营销单品名称 |
goodsId |
String(32) |
Y |
营销单品标识 |
goodsRemark |
String(256) |
N |
营销单品备注 |
quantity |
NUMBER(10) |
N |
营销单品数量 |
price |
NUMBER(15,4) |
N |
营销单品价格 |
type |
String(32) |
N |
记录类型 “WXREQ”:微信单品营销请求;“WXRESP”:微信单品营销渠道响应;“ALIREQ”:支付宝单品营销请求;“ALIRESP”:支付宝单品营销渠道响应 |
discountAmount |
NUMBER(15,4) |
Y |
抵扣金额 |
goodsDetailJson |
String(3000) |
N |
type为WXREQ/ALIREQ请求类型时,为原始传入的单品营销参数JSON字符串。type为WXRESP/ALIRESP时为渠道返回的单品营销响应原始信息JSON字符串 |
type参数说明:WXREQ”:微信单品营销请求;“WXRESP”:微信单品营销渠道响应;“ALIREQ”:支付宝单品营销请求;“ALIRESP”:支付宝单品营销渠道响应;
goodsDetailJson参数说明:type为WXREQ/ALIREQ请求类型时,为请求时传入值。type为WXRESP/ALIRESP时为渠道返回的响应值
7.1.1 type为“ALIRESP”时响应参数goodsDetailJson说明
参数 |
类型(字节长度) |
必填 |
参数说明 |
good_id |
String(32) |
Y |
商品的编号 |
discount_amount |
double |
Y |
抵扣金额 |
voucher_id |
String(32) |
Y |
劵id |
7.1.2 type为“WXRESP”时响应参数goodsDetailJson说明
参数 |
类型(字节长度) |
必填 |
参数说明 |
goods_id |
String |
Y |
商品编码 由半角的大小写字母、数字、中划线、下划线中的一种或几种组成 |
goods_remark |
String |
N |
商品备注 goods_remark 为备注字段,按照配置原样返回,字段内容在微信后台配置券时进行设置。例 1001 |
discount_amoun |
double |
Y |
商品优惠金额 单品的总优惠金额,单位为:元 |
quantity |
int |
Y |
优惠类型 用户购买的数量 |
price |
double |
Y |
商品价格 单位为:元。如果商户有优惠,需传输商户优惠后的单价(例如:用户对一笔 100 元的订单使用了商场发的纸质优惠券 100-50,则活动商品的单价应为原单价-50) |
7.1.3 type为“WXREQ”时响应参数goodsDetailJson说明
参数 |
类型(字节长度) |
必填 |
参数说明 |
goods_id |
String |
Y |
商品编码 由半角的大小写字母、数字、中划线、下划线中的一种或几种组成 |
wxpay_goods_id |
String |
N |
微信侧商品编号 |
goods_name |
String |
N |
商品名称 |
quantity |
int |
Y |
商品数量 用户购买的数量 |
price |
double |
Y |
商品价格 单位为:元 |
promotionId |
String |
Y |
券id 45678 |
7.1.4 type为“ALIREQ”时响应参数goodsDetailJson说明
参数 |
类型(字节长度) |
必填 |
参数说明 |
goods_id |
String(32) |
Y |
商品的编号 apple-01 商品 SKU 编码;卷配置中, 可优惠商品编码中配置的编码 |
alipay_goods_id |
String(32) |
N |
支付宝定义的统一商品编号 |
goods_name |
String(256) |
Y |
商品名称 ipad |
quantity |
int(10) |
Y |
商品数量 1 |
price |
double |
N |
商品单价,单位为元 100.00 |
goods_category |
String(24) |
N |
商品类目 34543238 |
categories_tree |
String(128) |
N |
商品类目树,商品类目根节点到叶子节点的类目id组成,类目id值使用 |分割124868003\ |
126232002\ |
126252004 |
body |
String(1000) |
N |
商品描述信息 例 特价手机 |
show_url |
String(400) |
N |
商品的展示地址 http://www.alipay.com/xxx.jpg |
7.2 银联 CupQrCouponDetail
参数 |
类型(字节长度) |
必填 |
参数说明 |
spnsrId |
double |
Y |
出资方,1:银联出资,2:付款方(比如银行)出资,3:商户出资offstAmt |
offstAmt |
double |
Y |
出资金额 ,单位为元 |
7.3 银联 CouponInfo
参数 |
类型(字节长度) |
必填 |
参数说明 |
amount |
Double |
Y |
清算金额 ,单位为元 |
origAmount |
Double |
Y |
订单金额, 单位为元,商户提交的订单金额 |
cupQrCouponDetail |
List |
N |
优惠信息-二维码,成功的二维码类交易交易必填,活动维度的优惠展示 |
issAddnData |
IssAddnData |
N |
付款方附加数据,交易成功返回,商品维度的优惠展示 |
cupAcpCouponInfo |
CupAcpCouponInfo |
N |
优惠信息全渠道,成功的全渠道类交易(如:Wap,手机控件 等)必填,活动维度的优惠展示 |
7.3.1 CupQrCouponDetail
参数 |
类型(字节长度) |
必填 |
参数说明 |
spnsrId |
double |
Y |
出资方,1:银联出资,2:付款方(比如银行)出资,3:商户出资offstAmt |
offstAmt |
double |
Y |
出资金额 ,单位为元 |
7.3.2 IssAddnData
参数 |
类型(字节长度) |
必填 |
参数说明 |
样例 |
dctDetail |
List |
N |
商品优惠信息 |
交易成功,且请求参数中的收款方附加信息域中的单品命中优惠。商品维度展示优惠信息。 |
7.3.2.1 DctDetail说明
参数 |
类型(字节长度) |
必填 |
参数说明 |
id |
String |
Y |
参与优惠的商品编号 |
dctId |
String |
Y |
优惠活动的编号 |
dctQuantity |
int |
Y |
商品优惠数量,本商品数量为 10,其中 2 件参示例:本商品数量为 10,其中 2 件参 |
dctPrice |
double |
Y |
商品优惠金额,单位:元。示例:商品单价10元,共 5件,其中2件参与优惠,每件优惠 3元,则本字段值为 6.00 |
addnInfo |
String |
N |
附加信息,内容自定义 |
7.3.3 CupAcpCouponInfo说明
参数 |
类型(字节长度) |
必填 |
参数说明 |
discountAmt |
double |
Y |
总的优惠金额,单位:元,注:退货的时候返回,表示总的优惠回退金额 |
mchtDiscountAmt |
double |
N |
商户出资金额,单位:元,注:退货的时候返回,表示商户出资的回退金额 |
activityId |
String |
N |
活动编号,票券编号、活动编号等,格式自定义 |
activityNm |
String |
N |
活动简称,优惠活动简称,可用于展示、打单等 |
addnPrintInfo |
String |
N |
活动打印信息,内容自定义 |
8、样例
8.1 extend_params
{
"cartTYpe": "00",
"order_mode": "01",
"seller_list": [{
"seller_id": "123"
}, {
"seller_id": "456"
}]
}
8.2 二级商户 sub_merchant
{
"merName": "二级商户名称",
"merShortName": "二级商户简称",
"merAddr": "二级商户地址",
"telephone": "二级商户服务电话",
"merNo": "二级商户编号",
"category": "类目",
"mrchntCertId": "身份证号"
}
8.3 收货地址 consignee_info
{
"consigneeName": "收货人姓名",
"consigneeAddr": "收货地址",
"transportationInfo": "物流配送信息",
"commodityName": "商品名称",
"commodityNumber": "商品数量"
}
8.4 coupon_info 银联二维码优惠信息
[
{
"spnsrId":"1",
"offstAmt":1
},
{
"spnsrId":"2",
"offstAmt":2
}
]
8.5 支付宝业务拓展参数extend_params_channel
{
"food_order_type": "qr_order"
}
9、附录
9.1 交易状态
枚举名称 |
枚举说明 |
WAIT_BUYER_PAY |
交易创建,等待买家付款。 |
TRADE_CLOSED |
在指定时间段内未支付时关闭的交易;客户主动关闭订单。 |
TRADE_SUCCESS |
交易成功,且可对该交易做操作,如:多级分润、退款等。 |
TRADE_PART_REFUND |
部分退款成功。 |
TRADE_ALL_REFUND |
全部退款成功。 |
WAIT_SELLER_SEND_GOODS |
买家已付款,等待卖家发货 |
WAIT_BUYER_CONFIRM_GOODS |
卖家已发货,等待买家确认 |
9.2 参考错误码
错误码 |
错误描述 |
解决方案 |
ACQ.SYSTEM_ERROR |
系统错误 |
请调用查询接口查询订单状态 |
ACQ.CONNECT_PAYGATE_TIME_OUT |
业务超时 |
请调用查询接口查询订单状态 |
ACQ.INVALID_PARAMETER |
参数无效 |
检查请求参数,修改后重新发起请求 |
9.3 支付网关编号
支付渠道代码 |
支付渠道 |
900000001 |
银联-支付宝 |
9000010 |
银联-微信 |
10810001 |
银联扫码-银联云闪付 |
10010001 |
网联-微信 |
10000012 |
网联-支付宝 |
---{"code":200,"message":"成功","data":null,"list":null}{"code":200,"message":"成功","data":null,"list":null}