文档介绍:天龙支付商户支付功能接口规范
2008年7月14日
功能说明:
本接口主要目的是为了让商户商城系统接入天龙支付平台,能够在天龙支付平台中进行支付,用户支付后,天龙支付会在第一时间内通知商户。
接口商户是根据天龙支付的接口文档传递相关的请求参数到天龙支付平台,天龙支付平台验证参数后,会引导用户到相应的页面进行支付操作,用户成功填入支付信息后,天龙支付平台将用户的支付成功与失败状态通知商户。
接口商户可以在自己的页面带入一些附加信息,天龙支付平台在回调时将该信息原样返回。
本接口支持那些语言?本平台接口支持大部分web语言,比如ASP,PHP,ASPX,JSP
支付流程图
网关接口规范
网关接口提交参数:
商户向平台网关提交的参数
网关地址:/pay/
参数
参数说明
参与签名
类型
备注
P_UserId
商户ID
是
整型数字
必须(如何查看商户ID?页:3
登录API平台,菜单选择“接入方式”,选择“API接入”,在下面的横条上就可以看见:您的商户ID是 xxxx
)
P_OrderId
商户订单号
是
字符串,最长32位
必须,在商户系统中保持唯一
P_CardId
卡类充值时的卡号
是
字符串,最长20位
卡类充值时必须,否则可为空
P_CardPass
卡类充值时的卡密
是
字符串,最长20位
卡类充值时必须,否则可为空
P_FaceValue
面值
是
float,保留2位小数
必须
P_ChannelId
充值类型
是
整型数字
必须(具体参数详见附录)
P_Subject
产品名称
否
字符串,最常20位
可为空
P_Price
产品价格
否
float,保留2位小数
必须,可传0
P_Quantity
产品数量
否
整型数字
必须
P_Description
产品描述
否
字符串,最常100位
可为空
P_Notic
用户附加信息
否
字符串,最常50位
可为空
P_Result_URL
充值状态通知地址
否
字符串,最长100位
必须
P_Notify_URL
充值后网页跳转地址
否
字符串,最长100位
可为空
P_PostKey
签名认证串
-
字符串
必须
说明:
签名认证postKey的生成:必须按照“参与签名”状态为“是”的参数按其顺序用“|”组合,最后加上用户密钥,然后进行32位的md5编码,比如:P_PostKey=md5_32(P_UserId| P_OrderId| P_CardId| P_CardPass P_|FaceValue| P_ChannelId|SalfStr),SalfStr是您在设置信息的时候,填写的安全码(如何更改安全密码?登录API平台,商户管理-->安全设置-->密钥设置,这里自己设置安全密钥)
Result_URL必须填写,而且是http://开头的绝对网络地址,否则充值成功后,您将得不到状态地址。
提交信息结果错误代码详见附录
接口提交示例:/? P_UserId=2000&P_OrderId=90898089890we8r098erewr&&P