图片来源：网络图片来源:网络
本文件描述了为手机支付行业提供的支付解决方案，用于内部相关开发和技术支持人员以及商户服务技术人员。文件从互动模式、签名、界面和注意事项等方面介绍了财付通的工作模式和开发过程。它还可以帮助开发人员快速掌握开发技巧，并可作为界面参数和参数类型的快速参考手册。
1.2读取对象
本手册供财付通开发商和为技术或业务人员服务的商户参考和查询
1.3业务条款
术语示例描述
商业租户编号1900000109机票厂账号仅用于记账，由租户自动分配10位号码。
密钥9ba 2380 ad 9 B2 aacb 96 BCA 514 ed a 27 AC 9为保证通信不被篡改，财付通和商户约定32位字符串，用于签名“sign”。
账号jpgyf@qq.com
财付通账号目前可以支持两种格式，qq号和电子邮件账号。
金额100000金额，默认为人民币，正确为分，1000表示人民币10.00元
2 Scheme Overview2.1行业背景
在电子商务中，商家、卖家和中介服务提供商是交易活动的三个环节。卖方选择货物并下订单。卖家确认订单后，买家通过中介服务提供商向商家支付货款，在此过程中，商家网站需要整合中介服务提供商的支付功能，使买家完成goods金额的支付。财付通除了提供支付接口外，作为专业的中介服务提供商，还提供结果查询接口和订单查询接口，帮助商户记录商品支付情况，让商户专注于商品服务。
商户货款以T0-T7频率结算至商业账户银行账户，并收取手续费。此流程由财付通自动完成。商户不需要相关的开发工作。
2.2界面介绍
接口名称请求网址功能描述结果描述
界面初始化https://wap.tenpay.com/cgi-bin/wappayv2.0/wappay_init.cgi调用界面时指定支付参数，完成卖家账户到商户账户的支付，采用跳页交互模式和后台通知交互模式。发起wap请求，通过token_id进行交互验证。
https://wap.tenpay.com/cgi-bin/wappayv2.0/wappay_gate.cgi支付接口
调用接口时指定支付参数，完成卖家账户到商户账户的支付，采用跳页交互模式和后台通知交互模式。结果以两种方式返回。一种方法是在前台的“callback_url”后面添加参数r eturning。另一种方法是在“callback_url”后面添加参数returning，要求后台“notify_url”响应接收通知。
订单查询界面http://wap.tenpay.com/cgi-bin/wapmainv2.0/ WM _ query _ order . CGI商户在后台查询任何订单，采用后台系统调用的交互方式。根据订单号和XML格式返回具体的订单内容和状态。
2.3业务实现流程
蓝色直箭头表示系统调用。向后的直箭头表示页面跳过。
商户请求交易发起:商户根据客户的支付行为生成订单，包括商户、商户订单号、金额等支付要素。并提交交易发起请求，获取token_id。
1)财付通收到商户交易发起请求后，系统创建财付通交易订单，同时生成token_id，并返回token_id。
2)商户请求WAP支付:商户根据token_id生成WAP支付请求。通过跳页方式引导用户进入财付通手机支付中心。
3)用户在财付通手机支付中心完成支付后，财付通拨打“notify_url”通知商户交易结果。
4)商户退货结果:根据扣钱成功的通知，完成发货的逻辑处理，退回财付通处理结果。
财付通确认交易完成后，跳回商户的“回调_url”。
2.4回拨“回拨_网址”
“回调_url”应为WAP页面，显示支付结果。
2.5通知“通知_网址”
在这种通知界面模式下，商户应保证“notify_url”的稳定性和可靠性。“notify_url”完成财付通交付的支付结果信息，交易结果信息将交付给“GET”的商户。财付通只退回成功支付的订单。
3 Data format3.1获取或发布
采用HTTP标准的GET或POST协议。为了保证接收机接收到正确的数据，如果传输的参数有特殊字符需要URL编码。
GET或POST一般用于跳转页面交互模式的请求或通知，后台系统调用模式的请求，后台通知模式的请求。
3.2可扩展标记语言数据格式
采用标准的XML协议。所有参数只存在于第一个节点中。不得采用多节点嵌套。
& lt？xml version="1.0 "编码="gb2312 "？>。
& ltroot>。
& ltretcode>。0<。/retcode>。
& ltretmsg>。& lt/retmsg>。
& lt合作伙伴>。1900000109<。/partner>。
& lt状态>。0<。/status>。
& ltsign>。8db 4a 01 3a 8 b 515349 c 307 f1 e 448 ce 836 & lt；/sign>。
& lt/root>。
一般会安排返回代码“retcode”参数。“0”表示呼叫成功。“非0”表示调用失败。如果失败，结果将不被签名，仅带有“retcode”和返回信息“retmsg”。
后台系统调用模式的回复一般使用XML。
3.3字符串格式
直接以简单字符为数据内容。一般用作后台通知模式的界面反馈，表示治疗是否成功。
返回结果结果描述
成功处理，“财付通”系统收到此结果后不会发出以下通知。
“失败”或其他字符处理不成功，泰尼派可能会收到此结果或可能不会收到任何结果；系统通过订单补充机制发出另一个通知。
4 Digital signature为了保证数据交付过程中数据的真实性和完整性，我们需要对数据进行数字签名，并在收到签名数据后进行签名验证。
数字签名包括两个步骤。首先，按照一定的规则拼接待签名的原始字符串。然后选择具体的算法和密钥来计算签名结果。
通常，失败的结果不需要签名。
4.1签名的原始字符串
无论是请求还是回复，无论是使用" get "、" post "还是" xml "，签名后的原始字符串都以如下方式组合成字符串。
1.除“符号”字段外，所有参数应按照字段的ascii码从小值到大值的顺序通过拼接。空值不得传输或包含在签名串中。
2.所有参数是指通信过程中实际出现的所有非空参数。即使字段在接口中没有指示，它们也需要带签名的字符串形式。如果退款界面中没有“测试”字段，在商户请求或财付通回复的情况下，“测试”有值，则“测试”字段应参与已签名的组字符串。
3.在签名的基元字符串中，字段名和字段值应使用不带网址编码的基元值。
4.财付通返回的回复或通知信息可能会因升级而增加参数。回复此签名时请注意条件。
示例:
调用一些接口，该接口有以下字段:
“合作伙伴，合计_费用，desc和附件”
实际调用接口时，所有字段的值如下。
partner=1900000109，total_fee=1，desc = a & amp；b，attach=，test=1
正确签名的基本字符串应为:
desc = a & amp；b&。partner=1900000109&。测试= 1 & amptotal_fee=1
常见的错误包括
desc = a % 26b & amp；partner=1900000109&。测试= 1 & amptotal_fee=1
desc = a & amp；b&。partner=1900000109&。total_fee=1
attach = & ampdesc = a & amp；b&。partner=1900000109&。测试= 1 & amptotal_fee=1
partner=1900000109&。total _ fee = 1 & ampdesc = a & amp；b&。测试=1
注意:Wap支付界面返回的结果参数表很特殊。第二点不适合。也就是说，所有的参数都是指描述接口的参数。
4.2签名算法
目前，签名算法暂时只支持MD5签名。
MD5签名
MD5是一种抽象生成算法。将商户的通信密钥的内容添加到签名原语字符串中，用于MD 5计算。形成的抽象字符串是有符号的结果。为了便于比较，有符号的结果可以统一转换为大写字符。
注意:签名时，将字符串转换为符合指定字符集“input_charset”的字节流。
MD5签名计算格式:
符号= Md5转换为大写
例如:
带符号的原始字符串是:input _ charset = GBK & amp；partner=1900000109&。total_fee=1
商户密匙:8db 4a 01 3a 8 b 515349 c 307 f1 e 448 ce 836
签名结果:
sign = MD5= 8 DB4 a 01 3a 8 b 515349 c 307 f1 e 448 ce 836
5 Order-supplementing mechanism至于后台通知互动模式，如果财付通收到商户的回复“没有成功”或者加班，那么财付通认为通知失败，财付通会通过一些策略定期发出通知，以提高通知的成功率，但财付通不能保证通知最终能成功。
由于后台通知的重新提交条件，考虑到同一通知可能会多次发给商业租户系统。商业租户系统必须能够正确处理重复通知。
财付通推荐的做法是，先查看相应业务数据的状态，收到通知进行处理后，再判断通知是否已经处理；通知未处理的，应当处理；如果已经处理，则返回“成功”，在检查和处理业务数据之前，采用数据锁进行并发控制，以避免由于函数重入而造成的数据混乱。
图片来源：网络图片来源:网络
6.1.1业务职能
发起“wap”请求，实现生成“token_id”的交互验证。
6.1.2交互模式
请求:跳过页面交互模式。
请求结果+通知:跳页交互模式+后台通知交互模式。
6.1.3请求参数列表
请求网址:https://wap.tenpay.com/cgi-bin/wappayv2.0/wappay_init.cgi
传递“获取”或“发布”请求
字段名变量名必填类型设计
业务参数
版本版本是字符串版本号。“版本”默认值为1.0。当前版本“ver”设置为2.0。
字符串字符集是字符串“1 UTF-8，2 GB2312”默认为1。
银行类型银行类型是字符串银行类型:Tenay由“0”财付通填写。
商品名称desc是字符串商品名称，32个字符以内
买方财付通账号买方_身份证号字符串用户财付通账号。如果商业财付通不传输参数。然后买家需要通过财付通支付页面输入财付通账号。
商户编号卖方_id是字符串商户编号，是财付通统一分配的10位正整数
商业订单号是字符串商业系统中的订单号，32个字符以内，包括字母。
总额总额_费用是整数总额，以“分”为单位，不包括任何字符和符号。
货币类型费用_类型是整数货币类型支持现金，目前只支持RNB。默认值为1:人民币。
通知地址通知网址是字符串网址收到财付通的通知，要求绝对路径，格式显示为255个字符以内的http://wap.tenpay.com/tenpay.asp。
前阶段地址回调_网址是字符串交易后跳过网址，要求绝对路径，格式为255个字符内的http://wap.tenpay.com/tenpay.asp。
附加信息无字符串商业租户的附加信息可用作扩展参数，长度在255个字符以内。
订单生成时间时间_开始无字符串订单生成时间格式为“yyyymmddhhmmss”。例如，“2009年12月25日9: 10:10”可以表示为“20091225091010”。时区是北京格林尼治时间+8。时间是从商户的服务器获取的。
订单时间超时_到期无字符串订单失败时间格式为“yyyymmddhhmmss”。例如“2009年12月27日9: 10:10”可以表示为“20091227091010”。时区是北京格林尼治时间+8。时间是从商户的服务器获取的。
签名是字符串 MD5签名结果，参见“MD5签名规则，第4章”
6.1.4返回结果并通知参数表
数据应按照可扩展标记语言格式实时返回
字段名变量名必填类型设计
业务参数
动态密码令牌标识是字符串由财付通生成“令牌标识”
成功的例子:
& lt？xml version="1.0 "编码="GB2312 "？>。
& ltroot>。
& lttoken_id>。20081113 F9 d 49 c 20 e8e 5c 8e 40 b 6107 EC 42259 e 41 & lt。/token_id>。
& lt/root>。
错误示例:
& lt？xml version="1.0 "编码="GB2312 "？>。
& ltroot>。
& lterr_info>。错误信息<。/err_info>。
& lt/root>。
6.2 Wap支付接口
6.2.1业务职能
用户通过“Wap支付界面”完成订单支付。
6.2.2交互模式
请求:跳过页面交互模式
返回结果:跳过页面交互模式
注意:后台通知交互模式
6.2.3请求参数列表
请求网址:https://wap.tenpay.com/cgi-bin/wappayv2.0/wappay_gate.cgi
通过“获取”或“发布”请求
字段名变量名必填类型设计
业务参数
动态密码令牌标识是字符串由财付通生成“令牌标识”
6.2.4返回结果参数表
页面返回是通过请求“callback_url”，采用“get”或“post”完成的。
字段名变量名必填类型设计
业务参数
返回的状态代码版本是字符串版本号。“版本”默认值为1.0。当前版本“ver”设置为2.0。
字符集字符集是字符串字符代码被确定为GBK和UTF-8。默认值为GBK。
支付结果支付_结果是内部支付结果:0-成功；其他-失败
财付通订单号交易_id Yes String财付通交易号，28位长值；第一个10位数是商业租户编号；最后8位是订单生产日期，例如20090415。最后10位是序列号。
商户订单号sp _ billno是字符串商业系统内的订单号，32个字符以内，包括字母。
总额总额_费用是整数总额，以“分”为单位，不包括任何字符和符号。
货币类型费用_类型是整数货币类型支持现金，默认值为1:人民币。
商户号卖方_身份证是字符串卖方账号
附加信息无字符串商业数据包，按原始状态返回
签名是字符串 MD5签名结果
仅对返回通知的协议参数进行签名
6.2.5通知结果参数表
后台通知通过请求“callback_url”完成，采用“get”或“post”。
字段名变量名必填类型设计
业务参数
版本号是字符串版本号。“版本”默认值为1.0。当前版本“ver”设置为2.0。
字符集字符集是字符串字符代码被确定为GB2312和UTF-8。默认值为GB2312。
支付结果支付_结果是内部支付结果:0-成功；其他-失败
支付结果信息支付_信息无字符串支付结果信息，支付成功时为空。
财付通订单号交易_id Yes String财付通交易号，28位长值；第一个10位数是商业租户编号；最后8位是订单生产日期，例如20090415。最后10位是序列号。
商户订单号sp _ billno是字符串商业系统内的订单号，32个字符以内，包括字母。
总额总额_费用是整数总额，以“分”为单位，不包括任何字符和符号。
货币类型费用_类型是整数货币类型支持现金，默认值为1:人民币。
商户号卖方_身份证是字符串卖方账号
附加信息无字符串商业数据包，按原始状态返回
签名是字符串 MD5签名结果
付款银行银行类型是字符串银行类型
银行订单号Bank _ billino No String银行订单号，如果是财付通的余额，则付款为空。
支付完成时间时间_结束是字符串支付完成时间，格式为“yyyyMMddhhmmss”。例如“2009年12月27日9: 10:10”可以表示为“20091227091010”。时区是北京时间GMT+8。时间是从商户的服务器获取的。
买方昵称购买_别名无字符串对应买方账号的加密字符串
6.2.6后台通知结果的反馈
财付通通知后台通过“notify_url”通知商户。商户完成业务处理后，要求以字符串形式反馈处理结果，内容如下。
返回结果指示结果
成功处理，“财付通”系统收到此结果后不会发出以下通知。
“失败”或其他“字符”处理不成功，天宝可能会收到此结果或可能不会收到任何结果；系统通过订单补充机制发出另一个通知。
6.3订购查询界面
6.3.1业务职能
根据商户订单号或财付通订单号查询财付通侧记录的具体订单信息
6.3.2交互模式
后台调用交互模式
6.3.3请求参数列表
请求:URL:http://WAP . tenpay . com/CGI-bin/wapmainv 2.0/WM _ query _ order . CGI
通过“获取”或“发布”请求
字段名变量名必填类型设计
业务参数
版本号是字符串版本号。“版本”默认值为1.0。当前版本“ver”设置为2.0。
商户号卖方_身份证是字符串卖方账号
商户订单号商户订单号字符串商户系统内部订单号，至少填写“商户订单号”和“交易标识”之一。同时，“transaction_id”优先。
财付通订单号交易标识号字符串财付通的交易订单，至少填写“sp _ billno”和“交易标识”之一。同时，“transaction_id”优先。
附加信息无字符串商业数据包，按原始状态返回
字符集字符集是字符串字符代码被确定为GB2312和UTF-8。默认值为GB2312。
签名是字符串 MD5签名结果
6.3.4回复参数表
数据应按照可扩展标记语言格式实时返回。
字段名变量名必填类型设计
业务参数
版本号是字符串版本号。“版本”默认值为1.0。当前版本“ver”设置为2.0。
字符集字符集是字符串字符代码被确定为GB2312和UTF-8。默认值为GB2312。
支付结果支付_结果是内部支付结果:0-成功；其他-失败
支付结果信息支付_信息无字符串支付结果信息，支付成功时为空。
财付通订单号交易_id Yes String财付通交易号，28位长值；第一个10位数是商业租户编号；最后8位是订单生产日期，例如20090415。最后10位是序列号。
商户订单号sp _ billno是字符串商业系统内的订单号，32个字符以内，包括字母。
总额总额_费用是整数总额，以“分”为单位，不包括任何字符和符号。
货币类型费用_类型是整数货币类型支持现金，默认值为1:人民币。
商户号卖方_身份证是字符串卖方账号
附加信息无字符串商业数据包，按原始状态返回
签名是字符串 MD5签名结果
付款银行银行类型是字符串银行类型
银行订单号Bank _ billino No String银行订单号，如果是财付通的余额，则付款为空。
支付完成时间时间_结束是字符串支付完成时间，格式为“yyyyMMddhhmmss”。例如“2009年12月27日9: 10:10”可以表示为“20091227091010”。时区是北京时间GMT+8。时间是从商户的服务器获取的。
买方昵称购买_别名无字符串对应买方账号的加密字符串
图片来源：网络图片来源:网络
2.“notify_url”是指财付通服务器直接向商户服务器发起请求，商户在处理时不能检查用户的“cookie”或“会话”。
3.“notify_url”可能会重复通知，商业租户需要重新处理，以避免多次交付。
4.“notify_url”收到通知，商户成功处理或支票订单已处理，标记“success”要求退货处理成功，告知财付通不要通知。
5.“notify_url”持续2分钟有效。商户应在收到通知后进行查询。
1.《notifying 北京翻译公司完成电子系统介绍英文翻译》援引自互联网，旨在传递更多网络信息知识，仅代表作者本人观点，与本网站无关，侵删请联系页脚下方联系方式。
2.《notifying 北京翻译公司完成电子系统介绍英文翻译》仅供读者参考，本网站未对该内容进行证实，对其原创性、真实性、完整性、及时性不作任何保证。
3.文章转载时请保留本站内容来源地址，https://www.lu-xu.com/yule/1672476.html