参数附录

支付渠道及说明

参数

名称

expend 参数

alipay

支付宝 App 支付

alipay参数

alipay_qr

支付宝正扫

alipay_qr参数

alipay_wap

支付宝 H5 支付

alipay_wap参数

alipay_lite

支付宝小程序支付

alipay_lite参数

alipay_scan

支付宝反扫

alipay_scan参数

wx_pub

微信公众号支付

wx_pub参数

wx_lite

微信小程序支付

wx_lite参数

wx_scan

微信反扫

wx_scan参数

union

银联云闪付 App(暂不支持)

union参数

union_qr

银联云闪付正扫(云闪付入驻)

union_qr参数

union_wap

银联云闪付 H5 支付(云闪付入驻)

union_wap参数

union_scan

银联云闪付反扫(云闪付入驻)

union_scan参数

支付渠道 expend参数 说明

根据支付是渠道的不同,您需要本章节内容,在发起交易时上送特定渠道所需要的额外参数,以及根据部分渠道支付成功返回的额外参数进行响应的处理。

alipay参数

请求参数

参数

类型

必填

描述

promotion_detail

JSON

N

优惠信息,详见 PromotionDetail对象

hb_fq_num

String(2)

N

支付金额大于等于 100 元时,可不指定分期数,用户可自由选择分期数;支付金额小于 100 元时,必须指定分期数,否则不支持花呗分期支付;指定分期数后用户不能更分期数;分期数目前只支持 3、6、12。花呗分期的手续费由用户自己承担。

返回参数

参数

描述

pay_info

支付信息,用于唤起支付宝

couponInfos

优惠券信息,使用 JSON格式

alipay_qr参数

请求参数

参数

类型

必填

描述

promotion_detail

JSON

N

优惠信息,详见 PromotionDetail对象

hb_fq_num

String(2)

N

支付金额大于等于 100 元时,可不指定分期数,用户可自由选择分期数;支付金额小于 100 元时,必须指定分期数,否则不支持花呗分期支付;指定分期数后用户不能更分期数;分期数目前只支持 3、6、12。花呗分期的手续费由用户自己承担。

返回参数

参数

描述

qrcode_url

二维码连接

couponInfos

优惠券信息,使用 JSON格式

alipay_wap参数

请求参数

参数

类型

必填

描述

promotion_detail

JSON

N

优惠信息,详见 PromotionDetail对象

hb_fq_num

String(2)

N

支付金额大于等于 100 元时,可不指定分期数,用户可自由选择分期数;支付金额小于 100 元时,必须指定分期数,否则不支持花呗分期支付;指定分期数后用户不能更分期数;分期数目前只支持 3、6、12。花呗分期的手续费由用户自己承担。

返回参数

参数

描述

pay_info

支付信息,用于唤起支付宝

couponInfos

优惠券信息,使用 JSON格式

alipay_lite参数

请求参数

参数

类型

必填

描述

buyer_id

String(100)

Y

买家的支付宝用户 id

buyer_logon_id

String(100)

N

买家支付宝账号

promotion_detail

JSON

N

优惠信息,详见 PromotionDetail对象

hb_fq_num

String(2)

N

支付金额大于等于 100 元时,可不指定分期数,用户可自由选择分期数;支付金额小于 100 元时,必须指定分期数,否则不支持花呗分期支付;指定分期数后用户不能更分期数;分期数目前只支持 3、6、12。花呗分期的手续费由用户自己承担。

返回参数

参数

描述

pay_info

支付信息,用于唤起支付宝

couponInfos

优惠券信息,使用 JSON格式

alipay_scan参数

请求参数

参数

类型

必填

描述

auth_code

String(128)

Y

扫码设备读出的条形码或者二维码信息

promotion_detail

JSON

N

优惠信息,详见 PromotionDetail对象

hb_fq_num

String(2)

N

支付金额大于等于 100 元时,可不指定分期数,用户可自由选择分期数;支付金额小于 100 元时,必须指定分期数,否则不支持花呗分期支付;指定分期数后用户不能更分期数;分期数目前只支持 3、6、12。花呗分期的手续费由用户自己承担。

返回参数

参数

描述

couponInfos

优惠券信息,使用 JSON格式

wx_pub参数

请求参数

参数

类型

必填

描述

open_id

String(128)

Y

微信用户关注商家公众号的 openid

is_raw

String(1)

N

是否原生态:”1”-是,”0”-否

callback_url

String(256)

N

交易完成后跳转的 URL, 需送绝对路径

limit_pay

String(1)

N

值为 1 时禁止使用信用卡支付

promotion_detail

JSON

N

优惠信息,详见 PromotionDetail对象

返回参数

参数

描述

token_id

动态口令, 用于后续接口调用中使用

pay_info

JSON格式 字符串,入参 isRaw=1 该值返回

open_id

支付完成后额外返回付款用户的微信 open_id

sub_open_id

在子商户 AppID 下的唯一标志

bank_type

支付完成后额外返回付款用户的付款银行类型 bank_type

couponInfos

优惠券信息,使用 JSON格式

wx_lite参数

请求参数

参数

类型

必填

描述

open_id

String(128)

Y

微信用户关注商家公众号的 openid

is_raw

String(1)

N

是否原生态:”1”-是,”0”-否

callback_url

String(256)

N

交易完成后跳转的 URL, 需送绝对路径

limit_pay

String(1)

N

值为 1 时禁止使用信用卡支付

promotion_detail

Map

N

优惠信息,详见 PromotionDetail对象

返回参数

参数

描述

token_id

动态口令, 用于后续接口调用中使用

pay_info

JSON格式 字符串,入参 isRaw=1 该值返回

open_id

支付完成后额外返回付款用户的微信 open_id

sub_open_id

在子商户 AppID 下的唯一标志

bank_type

支付完成后额外返回付款用户的付款银行类型 bank_type

couponInfos

优惠券信息,使用 JSON格式

wx_scan参数

请求参数

参数

类型

必填

描述

auth_code

String(128)

Y

扫码设备读出的条形码或者二维码信息

promotion_detail

JSON

N

优惠信息,详见 PromotionDetail对象

limit_pay

String(1)

N

值为1时禁止使用信用卡支付

返回参数

参数

描述

open_id

支付完成后额外返回付款用户的微信 open_id

sub_open_id

在子商户 AppID 下的唯一标志

couponInfos

优惠券信息,使用 JSON格式

union参数

请求参数

参数

类型

必填

描述

promotion_detail

JSON

N

优惠信息,详见 PromotionDetail对象

返回参数

参数

描述

pay_info

json格式字符串,app 下单成功后返回

couponInfos

优惠券信息,使用 JSON格式

union_qr参数

请求参数

参数

类型

必填

描述

promotion_detail

JSON

N

优惠信息,详见 PromotionDetail对象

返回参数

参数

描述

qrcode_url

二维码连接

couponInfos

优惠券信息,使用 JSON格式

union_wap参数

H5支付包含如下步骤(需要域名备案后才可以测试,详见 云闪付入驻):

1.获取临时授权码。浏览器跳转 云闪付授权地址,传入参数:version=1.0.0,redirectUrl=回调地址(商户备案域名下地址),银联返回两个参数respCode(00为成功)、userAuthCode(临时授权码,有效期5分钟)

2.调用 获取银联云闪付用户标识 获取用户ID

3.调用支付接口下单 特别注意:下单接口IP一定是客户手机IP,否则云闪付会拦截

4.用户支付

请求参数

参数

类型

必填

描述

promotion_detail

JSON

N

优惠信息,详见 PromotionDetail对象

user_identity_id

String(128)

Y

云闪付用户唯一标识,详见 获取银联云闪付用户标识

client_ip

String(46)

Y

实际发起支付的设备ip地址,未正确传入,会导致交易失败

callback_url

String(256)

N

交易完成后跳转的 URL, 需送绝对路径

返回参数

参数

描述

couponInfos

优惠券信息,使用 JSON格式

pay_url

支付跳转链接,H5支付下单成功时返回

union_scan参数

请求参数

参数

类型

必填

描述

promotion_detail

JSON

N

优惠信息,详见 PromotionDetail对象

auth_code

String(128)

Y

扫码设备读出的条形码或者二维码信息

返回参数

参数

描述

couponInfos

优惠券信息,使用 JSON格式

PromotionDetail对象

参数

类型

必填

描述

cost_price

String(14)

N

  • 订单原价

  • 商户侧一张小票订单可能被分多次支付,订单原价用于记录整张小票的交易金额

  • 当订单原价与支付金额不相等,则不享受优惠

  • 该字段主要用于防止同一张小票分多次支付,以享受多次优惠的情况,正常支付订单不必上传此参数

receipt_id

String(32)

N

商家小票 id

goods_detail

JSON

Y

订单包含的商品列表信息,详见 GoodsDetail对象

GoodsDetail对象

参数

类型

必填

描述

goods_id

String(32)

Y

商品编码,由半角的大小写字母、数字、中划线、下划线中的一种或几种组成

goods_name

String(256)

Y

商品名称

quantity

String(10)

Y

商品数量

price

String(12)

Y

商品单价,单位为:元。 如果商户有优惠,需传输商户优惠后的单价(例如:用户对一笔 100元 的订单使用了商场发的优惠券 100-50,则活动商品的单价应为原单价-50)

goods_category

String(24)

N

商品类目

goods_body

String(1000)

N

商品描述信息

show_url

String(400)

N

商品的展示地址

DeviceInfo 设备信息

参数

类型

必填

描述

device_type

String(2)

N

设备类型,1 :手机, 2 :平板, 3:手表, 4:PC

device_ip

String(64)

N

交易设备所在的公网 IP

device_mac

String(64)

N

交易设备 MAC

device_imei

String(64)

N

交易设备 IMEI

device_imsi

String(64)

N

交易设备 IMSI

device_iccId

String(64)

N

交易设备 ICCID

device_wifi_mac

String(64)

N

交易设备 WIFIMAC

device_gps

String(64)

N

交易设备 GPS

DivMembers 分账对象信息

参数

类型

必填

描述

member_id

String(64)

Y

分账用户 Member对象 的 id;若是商户本身时,传入0

amount

String(14)

Y

分账金额,精确到分,如0.50,1.00等,分账总金额必须等于主交易金额

fee_flag

String(1)

N

是否手续费承担方,N-否,Y-是,手续费承担方有且只能有一个

AccountInfo对象

参数

类型

必填

描述

card_id

String(2)

Y

银行卡号

card_name

String(64)

Y

银行卡对应的户名

cert_id

String(64)

N

证件号,银行账户类型为对私时,必填

cert_type

String(2)

N

证件类型,仅支持:00-身份证,银行账户类型为对私时,必填

tel_no

String(64)

Y

手机号

bank_code

String(8)

Y

银行编码,详见附录 银行代码

bank_name

String(64)

N

开户银行名称

bank_acct_type

String(1)

Y

银行账户类型:1-对公;2-对私

prov_code

String(4)

Y

银行账户开户银行所在省份编码 (省市编码

area_code

String(4)

Y

银行账户开户银行所在地区编码(省市编码

状态 status

属性值

描述

pending

交易处理中

succeeded

交易成功

failed

交易失败

货币代码 currency

属性值

描述

cny

人名币(默认值)

银行代码 bank_code

注: 更多银行代码详见 银行列表

银行名称

银行代码

工商银行

01020000

农业银行

01030000

中国银行

01040000

建设银行

01050000

交通银行

03010000

平安银行

03134402

中信银行

03020000

光大银行

03030000

华夏银行

03040000

民生银行

03050000

广发银行

03060000

招商银行

03080000

兴业银行

03090000

浦发银行

03100000

北京银行

03130011

天津银行

03130012

上海银行

03130031

江苏银行

03130032

重庆银行

03130050

大连银行

03132102

哈尔滨银行

03132301

南京银行

03133201

杭州银行

03133301

宁波银行

03133302

温州银行

03133308

恒丰银行

03150000

浙商银行

03160000