融易通支付接口使用手册

融易通支付接口使用手册内容摘要：

bel=39。 台胞证 39。 /value value v=39。 639。 label=39。 港澳通行证 39。 /value value v=39。 739。 label=39。 国际海员证 39。 /value value v=39。 839。 label=39。 外国人永久居住证 39。 /value value v=39。 939。 label=39。 其他 39。 /value input type=”text” name=”pIdNo” label=”证件证号 ”/ input type=”text” name=” phoneNo” label=”手机号码 ”/ /bank /bankSel /res 当银行网关已经指定且是直连交易时返回银行信息填写页面数据 返回内容说明 银行信息填写页面信息 返回 XML 结构 169。 北京融易通信息技术有限公司 14/35 ?xml version= encoding=utf8? res status value0/value!—根据 value判断处理是否成功， 0为成功， 1为失败 msg请选择银行网关 /msg /status payInfo !—银行信 息填写，银行网关已指定时返回 tseqtseq/tseq!—对应支付融易通订单流水号 urlurl/url!—银行信息填写提交的接口地址 !—包含银行网关、名称等信息的银行标签。 此处银行网关已制定，只会有一个 bank标签 bank gateIdgateId/gateId!—银行网关 namename/name !—网关名称 logoUrl logoUrl logoUrl!—银行 logo 图片的地址 !—以下是银行信息填写页面信息 input type=”text” name=”account” label=”信用卡号 ”/ input type=”text” name=”cvv” label=”cvv”/ input type=”password” name=”pwd” label=”密码 ”/ input name=”period” label=”卡有效期 ”/ input name=”useName” label=”持卡人姓名 ”/ radio name=”pIdType” label=”证件类型 ” value v=39。 139。 label=39。 身份证 39。 /value value v=39。 239。 label=39。 护照 39。 /value value v=39。 339。 label=39。 军官证 39。 /value value v=39。 439。 label=39。 回乡证 39。 /value value v=39。 539。 label=39。 台胞证 39。 /value value v=39。 639。 label=39。 港澳通行证 39。 /value value v=39。 739。 label=39。 国际海员证 39。 /value value v=39。 839。 label=39。 外国人永久居住证 39。 /value value v=39。 939。 label=39。 其他 39。 /value input type=”text” name=”pIdNo” label=”证件证号 ”/ input type=”text” name=” phoneNo” label=”手机号码 ”/ /bank /payInfo /res 网上直连信用卡支付提交银行账号信息接口  接口描述 ：支付方式为信用卡直连时，输入银行账号信息提交支付。 订单录入成功，则返回支付交易结果的 xml,验证签名显示详细信息；否则返回错误提示信息 xml。 169。 北京融易通信息技术有限公司 15/35  网上支付提交银行账号信息 通过 Form 表单以 Post方式提交，表单项采用隐含域方式。  提交账号信息的测试 URL 地址 : 提交账号信息的正式 URL 地址 :  调用 请求方法，并获取返回值 ,以下是接口所需的参数列表 参数 参数名称 非空 备注 tseq 支付融易通订单流水号 Y account 卡号 Y 信用卡号 cvv 贷记卡 CVV Y 信用卡必输 period 贷记卡有效期 Y 格式为 MM/YY 如 12/09 password 交易密码 N 为 已加密 数据 gateId 银行网关 Y pName 持卡人姓名 Y 信用卡必输 pIdType 持卡人证件类型 Y 持卡人证件类型 : 1 身份证 169。 北京融易通信息技术有限公司 16/35 2 – 护照 3 – 军官证 4 – 回乡证 5 – 台胞证 6 – 港澳通行证 7 – 国际海员证 8 外国人永久居住证 9– 其他 pIdNo 持卡人证件号码 Y phoneNo 手机号码 N remark 备注 N 当为直联卡且已经返回支付页面数据时，返回交易结果。 返回内容说明 返回处理结果 返回 XML 结构 ?xml version= encoding=utf8? res status value0/value!—根 据 value 判断处理是否成功， 0成功 1失败 msg订单录入成功 /msg /status transResult !—交易结果 merIdmerId/merId!—商户号 merDatemerDate/merDate!—订单提交日期 ordId ordId / ordId !—商户提交订单号 transAmttransAmt/transAmt!—交易金额 transType transType /transType!—交易类型 ,详见参数列表 gateIdgateId/gateId!—银行网关 transStattransStat/transStat!交易状态 ,0 初始化 1录入成功 2支付成功3失败 merPrivmerPriv/merPriv!—商户附加信息 tseqtseq/tseq !—对应支付融易通订单流水号 chkValuechkValue/chkValue!—交 易结果参与 数字签名 的字符串为 MerId + OrdId + TransAmt + MerDate + TransType + GateId + transStat+ MerPriv + tseq。 !注：验证签名时需要对 chkValue值进行 （ chkValue）处理 /transResult /res 失败返回 返回内容说明 包含处理失败的代码和失败原因提示 失败返回 XML 结构 ?xml version= encoding=utf8? res 169。 北京融易通信息技术有限公司 17/35 status value1/value! 错误代码 msgmsg/msg! 错误提示信息 /status /res 网上非直连支付银行选择提交接口  接口描述：对于网上非直连支付交易，选择银行网关，进行下一步，则会连同订单信息一起转发至相应的银行页面。 银行处理完毕后会异步返回处理结果。 (注：对于信用卡直连支付交易，选择银行网关时到银行信息填写页面，然后调用网上直连信用卡支付提交银行账号信息接口 )  网上非直连支付银行选择 通过 Post方式提交，表单项采用隐 含域方式。  银行选择提交的测试 URL 地址 : 银行选择提交的正式 URL 地址 :  调用 请求方法，并获取返回值 ,以下是接口所需的参数列表 参数 参数名称 非空 长度 备注 tseq 支付融易通订单流水号 Y gateId 银行网关号 Y 目 前对应融易通的银行网关 chkValue 商家签名 Y 参与数字签名的字符串为 tseq+ gateId。 169。 北京融易通信息技术有限公司 18/35 网上直 连信用卡一站支付接口  接口描述：商户一次提交订单信息及信用卡信息进行信用卡支付， 订单录入成功，则返回支付交易结果的 xml,验证签名显示详细信息；否则返回错误提示信息 xml。 参数 参数名称 非空 长度 备注 version 消息版本号 Y 2 固定为 10 merId 商户编号 Y 为商户分配的唯一编号 ordId 订单号 Y =20 由商户自定，保证一天内的唯一性即可。 orderDate 商户订单日期 Y 8 格式为 YYYYMMDD, 商户原始支付交易的商户日期。 transType 交 易类别 Y 1 A－信用卡 一站 支付交易 transAmt 订单金额 Y 12 单位 :元 10 位整数 +2 位小数 gateId 网关 Y 系统为银行支付通道定义的唯一标志号。 merPriv 商家 私有域 N 120 商户可以用此域放置成功返回 返回内容说明 银行支付页面 失败返回 返回内容说明 包含处理失败的代码和失败原因提示 失败返回 XML 结构 ?xml version= encoding=utf8? res status value1/value! 错误代码 msg/msg! 错误提示信息 /status /res 169。 北京融易通信息技术有限公司 19/35 商户私有信息，系统不会对该域进行任何修改，在返回交易应答时，同时将该数据返回给商户。 (该参数需要进行 Base64 编码后使用(签名或传参 ) retUrl 页面交易应答接收地址 N 120 支付完成后，支付网关会按照此地址将交易结果以 重定向的 方式发送到商户网站。 bgRetUrl 后台交易应答接收地址 Y 120 支付完成后，支付网关会按照此地址将交易结果以后台的方式发送到商户网站。 account 信用 卡号 Y cvv 信用卡 CVV Y 信用卡必输 period 信用卡 有效期 Y 格式为 MM/YY 如 12/09 password 信用卡 交易密码 N 信用卡 交易密码 pName 持卡人姓名 Y 信用卡必输 pIdType 持卡人证件类型 Y 持卡人证件类型 : 1 身份证 2 – 护照 3 – 军官证 4 – 回乡证 5 – 台胞证 6 – 港澳通行证 7 – 国际海员证 8 外国人永久居住证 9– 其他 pIdNo 持卡人证件号码 Y phoneNo 手机号码 N 169。 北京融易通信息技术有限公司 20/35 chkValue 商家签名 Y 256 商户发生命令参与数字签名的字符串为version + merId + ordId + transAmt + orderDate + transType + gateId + retUrl + bgRetUrl + account + cvv + period + pIdType + pIdNo 返回内容说明 返回 XML 结构 ?xml version= encoding=utf8? res status value0/value!—根据 value 判断处理是否成功， 0成功 1失败 msg订单录入成功 /msg /status transResult !—交易结果 merIdmerId/merId!—商户号 merDatemerDate/merDate!—订单提交日期 ordId ordId / ordId !—商户提交订单号 transAmttransAmt/transAmt!—交易金额 transType transType /transType!—交易类型 ,详见参数列表 gateIdgateId/gateId!。