畅捷支付-代收付产品接口说明书_v3.5

1、代收付产品接口说明书北京畅捷通支付技术有限公司代收付项目组畅捷支付代收付产品接口说明书编写说明标题：畅捷支付-代收付产品接口说明书类别：文档编辑软件：Microsoft Word 2010 中文版版本历史：版本作者审核人日期备注V2.8丁瑜2017-09-19正式发布版V2.9冯启东2017-10-21新增应用返回码和应用返回描述字段，对账增加接口参数V3.4杨柳2017-12-25新增同步单笔代扣（4.2.7），异步单笔代扣（4.2.8）和批量加急代扣（4.2.9） 增加字段 ： RoyaltyParameters，分账扩展字段V3.5韩跃强2018-02-28更新5.10应用返回码和应用返回描述目录第1章引言11.1编写目的11.2产品范围11.3规范及定义11.3.1 订单标识11.3.2 订单防重11.3.3 日期规范11.3.4 接口规范11.3.5 签名机制21.3.6 异步通知约定21.4接口使用说明2第2章业务场景32.1场景说明32.1.1 代付业务流程32.1.2 代扣业务流程4第3章网络及安全53.1网络53.2安全53.2.1 签名机制基本说明53.2.2 生成

2、待签名的字符串63.2.3 RSA签名73.2.4 RSA密钥生成方式73.3连通性测试9第4章技术接口104.1基本通信协议104.1.1 交易模式104.2服务接口114.2.1 公共请求参数114.2.2 同步返回基本参数124.2.3 同步单笔代付134.2.4 异步单笔代付154.2.5 批量代付加急184.2.6 批量代付非加急214.2.7 同步单笔代扣234.2.8 异步单笔代扣264.2.9 批量代扣加急294.2.10 批量代扣非加急324.2.11 单笔交易查询344.2.12 批量交易查询接口354.2.13 商户余额查询374.2.14 卡BIN信息查询384.2.15 单笔实名认证394.2.16 单笔实名认证查询414.2.17 批量实名认证424.2.18 批量实名认证查询444.2.19 多条件单笔业务查询464.2.20 交易明细查询484.2.21 批量业务多条件查询接口504.2.22 同步单笔裸代扣524.2.23 批量裸代扣加急554.3畅捷主动发起的服务接口594.3.1 代付状态变更594.3.2 代扣状态变更604.3.3 代收付对账文

3、件下载62第5章响应码645.1TransCode对照码表交易码645.2ID_TYPE对照码表-证件类型645.3BATCH_RET_CODE对照码表-批量655.4PLATFORM_RET_CODE对照码表655.5ORIGINAL_RET_CODE对照码表655.6Error_Code系统错误码655.7Error_Code业务错误码665.8出款状态675.9通知交易状态675.10AppRetcode对应AppRetMSG67第6章数据字典67IV第1章引言1.1 编写目的本操作文档用来指导畅捷支付商户实现与互联网支付系统的顺利对接。请相关技术开发人员、产品人员详细阅读本文档。1.2 产品范围对银行卡的代付及代扣1.3 规范及定义1.3.1 订单标识商户订单系统用商户网站唯一订单号标识每一笔支付单。畅捷支付用支付平台交易订单号标识进入系统的订单。1.3.2 订单防重接入畅捷支付的商户必须保证：商户网站订单号必须唯一，在畅捷支付系统内，商户号、商户订单号决定唯一一笔订单。1.3.3 日期规范所有给商户的清算和统计数据都以畅捷支付平台的清算日期为准。1.3.4 接口规范商户网站系

4、统和支付系统之间通过https协议来进行通信，接口以URL的形式提供以post的请求方式处理，接口说明中描述了post的请求参数。1.3.5 签名机制签名原文未经 URL Encoding 签名原文使用“_input_charset”字符集编码进行签名;1.3.6 异步通知约定商户正常处理完通知后必须输出“success”(不包含引号且小写)；如果商户处理通知没有输出“success”,则服务器会不断重发通知,重试时间间隔为:2m,10m,10m,1h,2h,6h,15h(共通知 8 次后不再通知)；通知采用 POST 方式发送。1.4 接口使用说明1. 查询交易接口调用失败不代表原交易订单失败；2. 支付确认接口同步响应为成功时就是成功、为失败时就是失败，其他状态请以异步通知结果为准或者通过查询接口确认订单状态。以免重复支付！请对照响应码表：5.5ORIGINAL_RET_CODE对照码表。3. 查询原业务是否成功，根据响应结果判断步骤：(1) 判断公共返回参数中AcceptStatus字段的参数，如果该字段返回S，且公共返回参数中的PlatformRetCode字段的参数为“000

5、0”，则表示畅捷支付系统受理成功；(2) 获取到具体接口返回参数中的OriginalRetCode字段，如果该字段为”000000”则可以判断为原业务状态为成功。(3) 如果OriginalRetCode字段不是“000000”，则表示原业务状态为“非成功”状态，客户需要咨询客服或者次日获取到对账文件进行对账后，方可进行重复发起原交易。4. 批量代付、批量代收、批量文件代付、批量文件代收、异步单笔代付、异步单笔代收交易后，再进行交易结果查询时，查询交易与原交易必须间隔在10分钟以上。第2章业务场景2.1 场景说明2.1.1 代付业务流程流程说明：1. 商户端主动发起代付前建议通过【商户余额查询】接口查询代付账户余额；2. 账户余额大于本次代付金额及手续费金额的总和；3. 若金额不足请进行账户充值；4. 金额充足调用【单笔代付】或【批量代付】接口发起代付请求；5. 商户调用【单笔交易查询】或【批量交易查询】接口核实代付结果。2.1.2 代扣业务流程流程说明：1. 商户端主动调用【单笔代扣】或【批量代扣】接口发起代扣请求；2. 代扣结果会同步通知给商户端；3. 商户可调用【单笔交易查询】或

6、【批量交易查询】接口核实代扣结果。第3章网络及安全3.1 网络1. 畅捷支付与合作方之间采用互联网网络进行通讯，带宽最低5M；2. 我们建议合作方应根据自己的实际情况增加防火墙等安全措施。3.2 安全3.2.1 签名机制基本说明1. 所有请求签名的参数，均需依照“参数名=参数值”的格式，按首字符字典顺序（ascii值大小）进行排序，如遇相同首字符，则判断第二个字符，以此类推。2. 所有待签名字符串据需根据“参数名1=参数值1&参数名2=参数值2&参数名N=参数值N”的规则进行拼接。3. 在对请求的参数做签名时，这些参数必须来源于请求参数列表，并且除去列表中的参数sign、sign_type。 . 在对请求的参数做签名时，对于请求参数列表中那些可空的参数，如果选择使用它们，那么这些参数的参数值必须不能为空或空值。4. 签名时将字符转化为字节流时，指定的字符集需与_input_charset保持一致；如果传递了_input_charset参数，则该参数也应包含在待签名数据中。5. 待签名数据应为参数原始值而非URL Encoding之后的值，例如：调用某接口需对请求参数email进行数字签

7、名时，待签名数据应为email=，而非email=test%。3.2.2 生成待签名的字符串3.2.2.1 在请需要参与签名的参数1. 在请求参数列表中，除sign、sign_type两个参数外，其他需使用的参数皆为要签名的参数。（个别接口中，参数sign_type也需参与签名。）2. 在通知返回参数列表中，除sign、sign_type两个参数外，所有通知返回的参数皆为要签名的参数。3.2.2.2 生成待签名字符串对于如下参数数组: string parameters=“Service=create_partner_trade_by_buyer”, “PartnerId=2088002007018916”, “InputCharset=gbk”, “ReturnUrl=http:/ “TrxId=709651609727679” ;对数组中的每一个值，按照从a到z的顺序进行排序，如遇相同首字符，则判断第二个字符，以此类推。排序完成后，将所有数组值以“&”字符连接起来，所得字符串即为待签名字符串：InputCharset=gbk&PartnerId=2088002007018916&R

8、eturnUrl=http:/ 空值的参数无需传递，也无需包含到待签名数据中；2. 签名时将字符转化成字节流时，指定的字符集与InputCharset需保持一致；3. 如果传递了InputCharset参数，则该参数也应包含在待签名数据中；4. 根据HTTP协议，传递参数的值中如存在特殊字符（如：&、等），则需对该值做URL Encoding，如此，请求接收方才能接收到正确的参数值。此情况下，待签名数据应为原生值而非encoding之后的值。例如：调用某接口需对请求参数email进行数字签名时，待签名数据应为email=，而非email=test%。3.2.3 RSA签名RSA签名时，私钥和公钥均需参与签名。商户的私钥与公钥皆由商户通过OPENSSL生成。商户入网支付平台系统后，支付平台运营同事下发支付平台公钥；同时商户把自己生成的公钥通过商户自助平台上传到支付平台系统。因此，请求签名时商户用到的是商户的私钥及钱包的公钥。3.2.3.1 加密字段值说明接口定义中需要加密处理的参数值，请使用支付平台的公钥RSA 算法实行加密。支付平台收到报文验签通过后，使用支付平台方的私钥进行解密。例：姓名加密与解密过程如下：1. 把户名转换成指定字符集的二进制数据：Byte(account_name, _input_charset)；2. 使用支付平台的公钥对结果进加密码: RSA.encrypt(byte,支付平台公钥)；3. 对加密后的数据二进制base64 字符转换: Base64.encode(RSA(byte,支付平台公钥)；4. 支付平台收到密文后，Base64.decode(密文)；5. 使用支付平台的私钥对二进制数据作解密 RSA.decrypt(byte,支付平台私钥)；6. 对解密后的二进制数据使用指定的字符集转换成字符串：String(byte,_input_charset)。3.2.3.

《畅捷支付-代收付产品接口说明书_v3.5》由会员徐俊分享，可在线阅读，更多相关《畅捷支付-代收付产品接口说明书_v3.5》请在金锄头文库上搜索。