快捷通-担保交易收单接口开发指南.docx

Haier ■

快捷通•担保交易收单接口开发指南

快捷通支付服务Kuaijietong Payment Service Co., Ltd.
快捷通涂程咬银台
E正H*««»： K* EF8收付 wrn公震
1.04元—*支付
M8:
IH9tf：
«lbT:
预任手机号：
没台快蜂的贩户.的支何OlttfrfAW
H5*»Sh 支H5有账户:
账户名 gAJKP名支付在码•.-■: • ret). 7VMMI
H5/SDK 一键支付:
<
收银台
话寒充值

枷款(元)
50.00

快理通支付眼务啪公司
付5O55C
衣业根行法蓄卡(4519)
g付款

SSffi行卡添加银行卡
曲8行情蓄营3613)
&3«&73工商！g行倍备号9241)
可用1.91元

收银台10:10
* 100% ■»

话受充值
50.00
支持银行及l&lfi
商户订瑞号 交AH丁垂号 交
收款方
4354567567785756756
阳公司困
付款方式
建设徵行倡记卡(3301)
收银台
商品名称的文字超过15个字出现…
57890.67元

确认付款直接跳转银行网银页面
商户/平台包装快捷通网银产品，用户在商户平台选定网银后直接跳转至指定的网银业务进 行支付。
用户

商户系统

快捷讪系统
1：用户浏览琴发起交易请求

1：用户浏览琴发起交易请求
1.1：商户系统调用快捷汕系统即时
到帐.传入对应的网银支付产品
码.银行编码，金额
1.2:浏览器中翻开对应银行的网银页面
V
11
11
1
1
1
变量名
是否必 填
类型
备注
例如
payproduct code
是
String(5)
支付产品码，
20：网银-借记卡
31：网银-信用卡
30：网银-综合
40：网银-B2B
30
amount
是
String(15)
应付金额，取值范围为
[0.01, .00],精确到小
75. 0()
T1.3:用户在网银贞面进行支付
如：pay product_code=30, amount=75. 00, bank_code=ABC

数点后两位。

bank_code
是
String(16)
银行/机构编码，参考附 录银行机构列表
ABC
表示使用农行对私综合网银渠道，支付金额75. 0()元。跳转到农行网银页面如下：
j (D - "V +
♦0 a i.//pay4bdwuxonV«buip«b*>k/P4ment»ZodeNewAct.ebfnOKfN-nOi8462$19644 。曜 C | ☆也■命今
已■，讷可 火W方ftW!A 曲KKQ511 实-乐•.. 8 qa2 X 全*曾SUCi - £... ■* Hound Q Kibana 各 HSCXMB □生产Ki5 8 CMD6林文甘卒会轻松在线
优*©:尊的*户，我行支忖界■近行了全新es蚯明g关沮祢的手SW9: 2017/10/20 的间:9:21:58:网上支付（5W : ARr5
订单信息75.00 目户：中鼬鼬…■&：快tta订.号：
KHSM爆行，■: |邸*行卡g户8IN\m子夏勺卡与
N码:以JL. ■不■庶玷宥
mra^：
罢法全曲小唤的忖.
S?政应WQ壬，»林二31之行2忖.
KX/KS支传

2.1.4. 3条码-主扫（返回链接）条码-主扫支付，即pc端生成商品扫码信息，用户扫码的支付方式。
用户
商户系统
快捷通系统
1：用户发起交易清求
1.4:用户扫描二维码进行支付
V
r
1.1：商户系统调用快捷迥系统叩时到 帐，支付方式传入封应的条码主扫支 付产品码，目标机构，金额 I
1.2:快捷通系统返回二维码连接
<
I 1.3:商户把二维码连接生 4—1成二维码展示给用户

变量名
是否必
填
类型
备注
例如
payproductcode
是
String(5)
支付产品码
64:主扫-借记卡
64

65:主扫-综合
73:条码-主扫-借记卡 线下
74:条码-主扫-综合线 下

amount
是
String(15)
应付金额，取值范围为 [0.01, .00],精确到小 数点后两位。
75. 00
targetorganizat
ion
是
String(16)
目标机构 WECHAT:微信 ALIPAY:支付宝 UPOP:银联
WECHAT
如：pay_product_code=64, amount=75.00, tcirget_organization=WECHAT 表示使用微信PC扫码，支付金额75. 00元。此时将返回微信支付的二维码链接如下:
{"code”:"S10000”, "msg":"接口调用成功","sign”:"快捷通 返回的签名值 ", "charset”:"UTF-8", 〃sign_type":"ITRUS", "biz_content”:{"out_trade_no”:”trade no〃:"status”:"P", "return url”:"weixin:〃wxpay/bizpayurl?pr=fEyU393"}}条码-主扫（返回支付宝订单号）
条码-主扫支付-返回支付宝订单号，即调用接口返回支付宝订单号，客户端唤起支付宝收银 台的支付方式。
变量名
是否必 填
类型
备注
例如
pay_product_codc
是
String(5)
支付产品码
73:条码-主扫-借记卡 （移动/线下）
74:条码-主扫-综合（移 动/线下）
73
amount
是
String(15)
应付金额，取值范围为 [0.01, 0. 00）,精确到 小数点后两位。
75.00
target_organization
是
String(16)
目标机构 ALIPAY:支付宝
ALIPAY
如：pay. product_code=73, amount=75. 00, target organization= ALIPAY, tradeinfo 中 交易扩展字段 trade_ext 填写{"unionQrCod。" ： "true", "ordcrSubOpenid":"支付宝用户 ID"} 表示使用支付宝下单，支付金额75. 00元。此时将返回支付宝订单号return no：
{"code〃："S10000〃，"msg〃：〃接口调用成功〃，〃sign”:"快捷通返回的签名值 ”, "charset":〃UTF-8”, "sign_type〃:"ITRUS”, "biz_content”:{"out trade no”:"trade no":"status”:"P”, "return no”:"202455"}}条码-公众号
条码-公众号支付，即使用微信公众号/微信小程序/支付宝服务窗唤起用户终端上微信/支付 宝APP进行支付的支付方式.

变量名
是否必 填
类型
备注
例如
payproductcodo
是
String(5)
支付产品码，
66:公众号/小程序/服 务窗-借记卡
67:公众号/小程序/服 务窗-综合
75：条码-公众号/小程序 /服务窗-借记卡线下
76：条码-公众号/小程序 /服务窗•综合线下
66
amount
是
String(15)
应付金额，取值范围为 [0.01, ,00],精确到小 数点后两位。
75. 00
targetorganizat
ion
是
String(16)
目标机构 WECHAT:微信 ALIPAY:支付宝
UPOP:银联
WECHAT
app_id
是
String(32)
公众号叩pid,请填写已 进件成功的APPJDo假设 以平台方名义进件，请 填写平台方APPJDo
wx1ObOf9e7ec69197e
opcnid
否
String(32)
微信用户标识必填
oldKv01A0sd7h8Z9BU uKpj-lTeiY
buyer_id
否
String(32)
支付宝用户标识必填

如：pay_product_code=66, amount=75. 0(), target_organ i zat i on=HTrHAT, app_ i d= wxl0b0f9e7ec69197e, open_id= o1dKvO1A0sd7h8Z9BUuKpj-ITeiY表示使用微信公众号支付，支付金额75. 00元。此时将返回微信唤起微信公众号的相关参数
如下：
{"code”:"SI 0000”, 〃msg":"接口调用成功"，"sign〃："快捷通返回的签名值 ", "charset”:"UTF-8”, "sign_type”:"ITRUS”, "biz content":{"app id":"wxl0b0f9e7ec69 197c", "inst_amount":"75. 00", "nonce str":"951f46d45b314b7cad3b5122b", "package":" prepay_id=wxc8〃，"pay_sign〃："Tilw/eLdnEr3o9Gkm8EIlJ+NUba£QGE7A3+dR7veS8D+zTX4PEl 21NtcPs9XnkjReG+744KkUeM0BRY8hEG7jq313J51JA0pBUJB2Wb57uXhj86r4I6XI3br/VIS8tZ96d eXCyC53jYx5/ggdWnm7U7CSWRHTwaKQAlkVlfuM8KoeGSffU+l.8noRBPNjWUTcJU7vClZ0Pdm/UVloa DNZlgohEbRA37Qzr4zmBzrgc5SSZGlH7BwAg+SlpxEPWP7RRK2BmrJThHd4fTtK6Lr4JFUJf4RhtU57 77TYIKlfwlQqcQpj8etNGtIymOu/Nd32KgstdlkfHHeBQzdJ7XO/bg==","prepay_id":"wxc8”, "s ign type”:"RSA", “time stamp”:"〃，"txn seq id”:"UP0P”, "txn time":"203"}}返回参数表格说明:
变量名
是否必填
参数说明
备注
样例
biz content
app .id
是
微信公众号
ID
供JSAPI调用参 数
wx 10b0f9e7ec69197e
inst amount
是
订单金额

75. 0()
nonce_str
是
随机字符串
供JSAPI调用参 数

package
是
订单详情扩 展字符串
供JSAPI调用参 数

signtype
是
签名方式
供JSAPI调用参 数

pay_sign
是
签名
供JSAPI调用参 数

prepay_id
是
预支付交易 会话标识
预支付会话标识， 该值有效期为20 分钟

time_stamp
是
时间戳
供JSAPI调用参 数

txntimc
否
交易时间
YYYYMMDDHH24MIS
S
203
txn seq id
是
交易序列号

UPOP
2.1.4.6 条码-APP
条码-APP支付,即商户在移动APP中唤起用户终端上微信/支付宝APP进行支付的支付方式。

变量名
是否必
填
类型
备注
例如
pay_product_code
是
String(5)
支付产品码，
68:条码-APP-借记卡
69:条码-APP・综合
68
amount
是
String(15)
应付金额，取值范围为 [0.01, 0. 00),精确到 小数点后两位。
75.00
target_organization
是
String( 16)
目标机构 WECHAT:微信
WECHAT
app_id
是
String(32)
APP的appid,请填写己 进件成功的APPJDo假设 以平台方名义进件，请 填写平台方APPJDo
wxl0b0f9e7ec69197e
如 :pay_product_code=68,amount=75.00,target_organization=WECHAT,app_id=wx!0b0f9e7ec69197e
表示使用微信APP支付，支付金额75.00元。此时将返回唤起微信APP的相关响应报文如 下：
{"code“:”SI0000”,”msg":”接口调用成功",”sign”:”快捷通返回的签名值 ",,,charset,,:,,UTF-8"；,sign_typc,,:',ITRUS",,,biz_content,,:{"app_id":,,wxl0b0^e7ec69197e,\,,inst ,amount":,'75.00,,；,nonce_str":,,6fTOeba89cdda70',,"package":,,Sign=WXPay',,"pay_sign,,:,,Tilw/e LdnEr3o9Gkm8EI 1 J+NUbatQGE7A3+dR7veS8D+zTX4PEl 2INtcPs9XnkjReG+744KkUeMOB RY8hEG7jq313J51JA0pBUJB2Wb57uXhj86r4I6XI3bi7VIS8【Z96deXCyC53jYx5/ggdWnm7U7 CSWRHTwaKQA 1 kVlfuM8KoeGSffU+L8noRBPNjWUTcJU7vClZOPdm/UV loaDNZIgohEbR A37Qzr4zniBzrgc5SSZGlH7BwAg+SlpxEPWP7RRK2BmrJThHd4frtK6Lr4JFUJf4RhtU5777T YIK1 fw I QqcQpj8etNGtIym0u/Nd32Kgstd 1 kfHHeBQzdJ7XO/bg=="；'prepayJd,,:,,wx 1204cdef3 99cd”,”partner id”:””,”time stamp”:"”}}返回参数表格说明:
变量名
是否必填
参数说明
备注
样例
biz content

app_id
是
微信APP的
APPID
供JSAPI调用字 段
wx 10b0f9e7ec69197e
inst amount
是
订单金额

75.00

noncc_str

随机字符串
供JSAPI调用字
段

package
是
订单详情扩 展字符串
供JSAPI调用字 段

pay_sign
是
签名
供JSAPI调用字 段

prcpay_id
是
预支付交易 会话标识
预支付会话标识， 该值有效期为20 分钟，供JSAPI 调用字段

time_stamp
是
时间戳
供JSAPI调用字
段

partner_id
是
商户号
微信支付分配的 商户号
供JSAPI调用字 段

协议支付根据平台/商户和快捷通签订的协议分为三种情况：
1、支付需要验证码：平台/商户对存在签约关系的银行卡发起交易请求，快捷通触发验证码 至用户银行卡预留手机号，同时返回支付token,平台/商户使用支付token发起支付确认请 求。
2、支付无需验证码:商户/平台对存在签约关系的银行卡通过调用担保交易收单网关接口（api 收银台类型）-接口可直接发起交易请求，完成扣款并返回交易结果。
3、支付阶段短信验证码可发可不发：那么由快捷通实时监控风控规那么动态判断是否发送，此 种情况每笔交易发起之前，支付阶段是否发送短信不可确定，调用担保交易收单网关接口返 回可获得短信发送标识。
注:商户支付阶段是否发送短信根据商户业务使用场景、风险等级来确定，在商户中请入网 阶段即已确定支付阶段是否需要发送支付短信验证。
支持签约+支付和签约并支付+支付两种方式；签约+支付指签约流程和支付流程分开，第一 步完成签约获取协议号后，再使用协议号进行支付；签约并支付+支付指签约和支付流程合 并，使用银行卡四/六要素信息进行签约并支付，并在支付过程中获取协议号，后续使用协 议号进行支付。
假设原交易未支付，可再次调用担保交易收单网关接口获取短信码和支付tokeno并需要调用 协议支付/直接支付-支付确认接口来完成最后的支付,参考:协议支付/直接支付-支付确认。
变量名
是否
必填
类型
备注
例如
pay_product_
code
是
String(5)
51-快捷借记卡,52-快捷贷记
卡

amount
是
String(15)
应付金额，取值范围为
[0.01, .00],精确到小数点
后两位。
75. 00
tokenid
否
String (34)
协议号：调用协议支付-签约 触发短信验证，协议支付-签 约确认获得该值，参考：1.拗 议支付-签约触发短信验证
2.协议支付-签约确认3. > 议支付-签约结果查询

signing_pay
否
String(l)
签约并支付:需要使用时固定 传:Y,新卡第一次签约快捷通 时使用，加上下面的银行卡四 要素字段进行签约并支付.当 token_id有值和 signing pay=Y时会报错，不
Y
4.2：返回支付结果43：返回支付结果
I用户

商户系统

快雄通系统

用户

商户系统

快雄通系统

1:用户发起签约
1.3： It用户输入让用验证码
2输入裁证码提交
2.3:返回签约坊果
匕
3:用户发起协议支付交易清求
1.1：调用快捷通接口-签约接口 』！
1.2：返州签约高座短信验证 n|
《 \
2.1：调用快捷通接口-签约短信确认接口
厂一一一』
（支付方式埴写协议支付支付产从） I
2.2:返[■签约结果
3.12:1.无短伯验旺，返回支付结果
3.1.3:1.无短侑脸如 返回支付结果2.有短信验证,返回需要短佰般证并发送短信
2,有展示凝证吗输入框
w
1 3.1.1:根据风险控制判定
*」 是否需要短信脸证
4：有如信驶证.用户输入驶证码提交
4.1:调用快捷通接LJ-支付确认接口

使用签约并支付时该字段为 空或者设置N。

bank_card_
no
否
String(32)
银行卡号，字母数字
signing pay=Y 时必填

phone_num
否
String(ll,
14)
手机号码，数字 signing pay=Y 时必填

bank_accou
nt_name
否
String(32)
银行卡账户名，不能包含
数字
signing pay=Y 时必填
张三
certificat
es_type
否
String(2)
证件类型参考附录证件类
M
signing pay=Y 时必填
01
certificat es number
否
String(50)
证件号码
signing pay=Y 时必填

cvv2
否
String(3,4)
平安码，信用卡必传

valid_date
否
String(7)
信用卡有效期YYYY/MM,
信用卡必传
2020/11
如：
--借记卡快捷签约并支付pay_product_codc=51, amount=0.01, signing_pay=Y, bank_card_no=t艮彳j：卡号，phone_num二银 行预留手机号码,bank_account_name=持卡人名称,certificates_type=OI, certificates_number= 身份证号
--信用卡快捷签约并支付pay_product_code=52, amount=0.01, signing_pay=Y, bank_card_no二信用卡卡号，phone_num= 银行预留手机号码，bank_account_namc=持卡人名称，ccrtificates_typc=01, certificates_iiumber=身份证号,cvv2=信用卡 CVV2. valid_date=2020/l 1
表示使用快捷支付进行签约并支付操作(协议支付可能存在发送短信的情况本例如为需要发 送短信的返回结果，假设不发送短信清参考支付确认后返回的信息例如)： {“code”：”S10000”，”msg”：" 接_□ _调用成功快捷通签名".•'charset": ,,utf-8" , "si gn_typeH: "ITRUS", "bi z.content": {,,out_trade_nou: "M, "pa y.token": “C182240”，"trade-no":'M,, "token_id,,: "Z", "status'1: "M"}}
返回内容表格说明：
变量名
是否必填
字段说明
备注
样例
biz conlent
文档编号：-002
修订控制页
序列
修订内容简述
修订日期
版本
拟稿人
己评审
1
文档编写
2017-08-22

何潘慰
王凯
2
交易达成接口业务参 数名
or i_out_trade_no改 成origouttradeno
2017-10-31

饶贤胤
王凯
3
新增京东扫码支付方 式
2017-11-29

饶贤胤
王凯
4
分润信息支持传登录 号或商户号
2017-12-25
VI. 0. 1
饶贤胤
王凯
5
交易查询接口响应参 数新增
2018-01-18
VI. 0.2
何潘慰
王凯
6
增加SDK收银台类型
2018-05-28
VI. 0.3
饶贤胤
王凯
7
增加条码支付-主扫， 条码支付-公众号支付 方式，以及删除多余的 金币，定金多个多余的 参数：增加协议支付 API担保交易
2018-08-06
VI. 0.4
雷大进
王凯
8
重整担保交易文档格 式，规范相关描述
2018-09-13
VI. 0.5
朱伟
王凯
9
增加微信APP支付方式
2018-11-12

李剑

10
增加转账支付方式
2019-4-18

饶贤胤
袁凯
11
增加条码-主扫返回值
2019-07-15

李剑

12
担保交易收单网关接 门增加交易信息交易 扩展字段说明
2019-08-12

李剑

--调用支付确认接口后返回的信息:
out_tradc_no
'是
商户订单号
第三方商户传递 给快捷通的订单 号

pay_token
是
支付令牌
调用支付确认接 口
agreeinent_pay_co
nfimi时使用
C182240
(oken_id
是
协议支付号
快捷通返回的协 议支付号,再次使 用协议支付时可 以用此号进行支 付
Z
trade_no
是
交易订单号
快捷通生成的交 易订单号,后续可 以根据该订单号 进行查询

status
是
订单状态
标识发送短信
M
{”code”：”S10000”，”msg”：“ 接口调用成功","sign":"快捷通签名 ”，"charset":”utf-8”，”si gn_type":"ITRUS","biz_contentH:{"out.trade.no":,,H,” re 2018-09-0619:02:18", ,,trade no,,:,,,,t "status**: ”S“, Hpay ti me": "2018-09-06 19:02:18"}}
直接支付
该交易适用于理财到账、第三方缴费、保险理赔、公益事业、充值、网络购 物、预定等场景，是一种无需签约，可直接无协议完成的支付，每笔交易均需验 证银行卡账户信息并进行短信验证完成支付的产品.
商户使用银行卡四要素发起支付申请获取支付token和短信验证码，并需要调用协议支付/ 直接支付•支付确认接口来完成最后的支付,参考:协议支付/直接支付-支付确认

变量名
是否必填
类型
备注
例如
pay_produc t code
是
String(5)
55一直接支付-借记卡
56一直接支付-贷记卡
56
amount
是
String(15)
应付金额，取值范围为
[0.01, .00],精确到小 数点后两位。
75. 00
bank_card_
no
是
String(32)
银行卡号，字母数字

phone_num
是
String(l1,1
4)
手机号码，数字

bank_accou
nt_name
是
String (32)
银行卡账户名，不能包
含数字
张三
certificat es type
是
String (2)
证件类型参考
01
certificat es number
是
String (50)
证件号码

cvv2
否
String(3)
平安码，信用卡必传

valid date
否
String(7)
信用卡有效期YYYY/MM
2020/11
-借记卡直接支付pay_product_code=55, amount=0.01, bank_card_no=银行卡号，phone_num=银行预留手机号码, bank_account_nanie=持卡人名称,certificates_type=O 1, certificates_number=^f^iiE^ --信用卡直接支付
pay_product_code=56, amount=0.01, bank_card_no=信用卡卡号，phone_num=银行预留手机号 码，bank_account_namc=持 卡人 名称，certificates_typc=O 1, ccrtificates_numbcr=身份证 号,cvv2=信用卡 CVV2, valid_date=2020/I I表示使用直接支付（直接支付肯定需要发送短信验证）：
{“code”：”S10000”，“msg”：” 接口调用成功","sign":M 快捷通签名 "/'charset": "UTF-S", "sign.type": "ITRUS", "bi z_contentH: {Hout_trade_no":,,H, npa y_tokenH:,,C182240M, "trade_no"“status”: ”M”}}返回内容表格说明:
变量名
是否必填
字段说明
备注
样例
biz content

out_trade_no
是
商户订单号
第三方商户传递 给快捷通的订单 号

pay_token
是
支付令牌
调用支付确认接
□
agreement_pay_co
nfirm时使用
C182240
（rade_no
是
交易订单号
快捷通生成的交 易订单号,后续可 以根据该订单号
进行查询

status
是
订单状态
标识发送短信
M
--调用支付确认接口后返回的信息:
{“code”：”S10000”，”msg”：“ 接口调用成功 ”，”sign”：“ 快捷通签名H,"charset":"UTF-8n,usign_type":"ITRUS","biz_content”：{"oujtrade_no”：”“，Hre turn_time":"2018-09-06
19:02:18n,"trade_no":,,M, "status": "S", “pay* me": "2018-09-06 19:02:18"}}同步响应报文（同步应答）
变量名
是否 必填
备注
例如
oul lrade no
是
平台（商户）订单号

trade no
是
快捷通订单号

status
是
订单状态，
S-成功
P-处理中
F-失败
S
pay_lime
否
支付时间，格式"yyyy-MM-dd
HH:mm:ss”
2018-09-06 19:02:18

转账支付转账支付主要用于将线上创立的消费订单，转变到线下支付，即线下转账打款的方式完成此 笔交易。
转账支付流程：
用户
商户
快捷通
银行
——提交支付请求
展示打牧信息及PWE码

变量名
是否必 填
类型
备注
例如
pay_product_code
是
String(5)
支付产品码
78:转账支付-对公
79:转账支付-对私
79
amount
是
String(15)
应付金额，取值范围为 [0.01, .00],精确到小 数点后两位。
75. 00
bankcode
是
String(16)
银行编码，参考附录银 行机构列表
ABC
bank_card_no
是
String(32)
付款银行卡号，字母数 字

bank_accoun t_nam
e
是
String(32)
付款银行卡账户名，不 能包含数字
张三
如：pay_product_codc=79, amount=75.00, bank_code=ABC, bank_card_no=, bank_account_name 二张三表示使用线下打款方式，支付金额75. 00元。此时将返回线下打款的目标银行账户信息和匹 配码如下：
{"code” :〃S10000”, "msg":"接口调用成功〃,〃sign”:"快捷通返回的签名值 ”, "charset”:"UTF-8", "sign typc”:"ITRUS", "biz contcnt”:{"out_tradc_no”:"trade _no":"”, "status”: "P", 〃makch_code〃: "1234〃, "transfer_bank_account_name〃:〃快捷通支 付服务"，"transfer bank card no”:" ", "transfcr bank branch nam。"："支付机 构备付金集中存管账户"}}同步响应报文（同步应答）
变量名
是否
必填
备注
例如
outtrade no
是
平台（商户）订单号

tradeno
是
快捷通订单号

status
是
订单状态， s-成功
P—处理中
F-失败
P
return url
否
返回链接

paytime
否
支付时间，格式"yyyy-MM-dd

return_time
否
接口返回时间,格式"yyyy-MM-dd
2017-06-24 14:12:03
memo
否
返回备注

2.2协议支付•签约接口
本接口服务名为card_register_apply,用于公共请求报文的service字段；接口版本号为1.1, 用于公共请求报文的version字段。
功能介绍该接口用于协议支付交易发起前，实现对持卡人账户基本信息一致性与有效性的验证，同时触发短信验证码。该阶段商户可获取用户银行卡对应的协议号，在完成签约确认后，使用该 协议号进行扣款操作。
协议支付签约包含两个流程：身份信息认证及签约推进。整体业务流程图如下：
商户
快捷通
发卡行
持卡人请求参数
变量名
是否
必填
类型
备注
例如
bankaccountnamo
是
String(32)
银行卡账户名，不能包含数
字
张三
certificatestype
是
String(2)
证件类型，
参考附录证件类型
01
certificates numb er
是
String(50)
证件号码，与证件类型匹配
使用

bank_card_no
是
String(6, 32
)
银行卡号，字母数字

cvv2
否
String(3)
平安码，信用卡必传

validdate
否
String(7)
信用卡有效期YYYY/MM
2020/11
phone num
是
String(ll)
手机号码

pay product code
是
String(5)
支付产品码
51
extension
否
String(200)
备注

2.2.3 同
步响应报文（同步应答）
变量名
是否必填
备注
例如
token i
是
银行卡签约协议号（未做签约
Z68365
说明：
(1

确认的协议号为不可用状态）

1. 平台/商户发起，用户银行卡和平台/商户达成签约关系的申请接口，发送验证码到用户银 行卡预留手机号（验证码有效期为5分钟）并返回协议号。
2. 协议号为用户银行卡与平台/商户签约关系的协议号，用于发起支付交易请求，同一张银 行卡在同一•个平台/商户下的协议号唯一。
2.3协议支付•签约确认本接口服务名为card_registcr_advance,用于公共请求报文的service字段;接口版本号为1.0, 用于公共请求报文的version字段。
功能介绍由平台/商户发起，调用签约中请接口后，再调用此接口验证用户预留手机号验证码达成签 约关系。
请求参数
变量名
是否
必填
类型
备注
例如
token_id
是
String(34)
银行卡协议
号
Z68365
verify code
是
String(6)
手机验证码
668854
extension
否
String(200)
备注

同步响应报文（同步应答）
变量名
是否必填
备注
例如
tokenid
是
银行卡签约协议号

2.4协议支付•签约结果查询本接I I服务名为card_rcgistcr_qucry,用于公共请求报文的service字段；接I I版本号为I. I, 用于公共请求报文的version字段。
功能介绍由平台/商户发起，查询用户银行卡是否己完成签约并返回协议号。
变量名
是否
必填
类型
备注
例如
bank_card_no
是
String(6,3
2)
银行卡号，字母数字

pay_product_cod
e
是
String(5)
支付产品码
51

同步响应报文（同步应答）
变量名
备注
例如
token id
银行卡签约协议号
Z68365
status
签约协议号当前状态
T：初始化（只申请未确认）
0：已签约
2.5协议支付•解约本接口服务名为card_register_abandon,用于公共请求报文的senice字段;接口版本号为1.0, 用于公共请求报文的version字段。
功能介绍
由平台/商户发起，解除用户银行卡和平台/商户的签约关系。解除签约后，无法通过协议号在当前平台/商户下完成快捷支付，业务流程如下：
持卡人

持卡人
商