API接口文档

版本号1.0

2008年7月14日

功能说明：

本接口主要目的是为了让商户商城系统接入阿宝支付平台，能够在阿宝支付平台中进行支付，用户支付后，阿宝支付会在第一时间内通知商户。

接口商户是根据阿宝支付的接口文档传递相关的请求参数到阿宝支付平台，阿宝支付平台验证参数后，会引导用户到相应的页面进行支付操作，用户成功填入支付信息后，阿宝支付平台将用户的支付成功与失败状态通知商户。

接口商户可以在自己的页面带入一些附加信息，阿宝支付平台在回调时将该信息原样返回。

本接口支持那些语言？本平台接口支持大部分web语言，比如ASP，PHP，ASPX，JSP

支付流程图

网关接口规范

（一）网关接口提交参数：

商户向平台网关提交的参数

网关地址：http://www.tl-pay.com/pay/gateway.asp

a)签名认证postKey的生成：必须按照“参与签名”状态为“是”的参数按其顺序用“|”组合，最后加上用户密钥，然后进行32位的md5编码，比如：P_PostKey=md5_32(P_UserId| P_OrderId| P_CardId| P_CardPass P_|FaceValue| P_ChannelId|SalfStr)，SalfStr是您在设置信息的时候，填写的安全码（如何更改安全密码？登录API平台，商户管理-->安全设置-->密钥设置，这里自己设置安全密钥）

b)Result_URL必须填写，而且是http://开头的绝对网络地址，否则充值成功后，您将得不到状态地址。

c)提交信息结果 错误代码详见附录

d)接口提交示例：http://www.xxx.com/pay/gataway.asp? P_UserId=2000&P_OrderId=90800we8r098erewr&&P_CardId=S099809342343443&P_CardPass=9032849&&P_FaceValue=10.00&&P_ChannelId=3&P_Subject=MyPay&P_Price=10.00&P_Quantity=1&P_Description=MyPay&&P_Notic=sometext&&P_PostKey=SDFS098KLJLKSJDFSKLJLKKLSF&P_Result_url=http://www.yousite.com/result.asp&P_Notify_URL= http://www.yousite.com/notify.asp

e)示例中：www.xxx.com是平台地址，http://www.yousite.com/result.asp是您用于接收充值报告的回调地址，当用户通过接口充值成功后，平台后台自动调用这个地址；http://www.yousite.com/notify.asp是用户充值成功后点“去商户取货”的转向地址

（二）充值状态回调/商户取货转向 参数说明

充值状态回调：用户通过本平台网关充值后，本平台接收到充值报告状态时，立即向您在提交网关参数中的P_Result_URL（充值状态回调地址），传递充值报告，您根据这个充值报告的状态，决定给是否给用户增加网站服务；

商户取货转向：在提交到API接口的时候，如果正确传递了P_Notify_URL参数，那么在商户充值成功后点“到商户取货”时，就自动转向到P_Notify_URL所指的地址，同时跟上以下参数表的所有参数。

以下是充值报告状态参数列表：

●签名认证postKey的生成：必须按照“参与签名”状态为“是”的参数按其顺序用“|”组合，最后加上用户密钥，然后进行32位的md5编码，比如：P_PostKey=md5_32(P_UserId| P_OrderId| P_CardId| P_CardPass| P_FaceValue| P_ChannelId|SalfStr)，SalfStr是您在设置信息的时候，填写的安全码。

●ErrCode=0为充值成功

●接收成功请在页面上显示errCode=0

附录

1.充值类型附表

注意：此表是当平台主没有删除原始通道的情况下才有用，如果API平台主删除原始通道，增加了自己的通道，就不能按照此表，要按照平台主的设置。如果您在商户后台的“支付方式”中，看到前面的ID跟此表的ID不对应时，那说明平台主已经修改过了。

0|提交或者是充值成功

101|商户ID为空

102|卡号不合法

103|卡密不合法

104|卡号太长

105|卡密太长

106|面值数据不合法

107|充值类型错误

108|游戏用户名过长

109|用户不存在

110|加密串postKey错误

111|该卡号已经被使用过

112|卡号类型不存在

113|未开通此通道或者业务

114|系统配置错误

115|卡号卡密或者面值不相符合

116|未知错误

117|未知错误

118|商户订单号为空

119|商户订单号太长

120|充值金额不合法

121|产品名称太长

122|产品描述文字太多

123|产品单价不是数字

124|用户自定义信息文字太多

125|notify_url太长

126|result_url太长