天龙支付API支付台接口文档.docVIP

天龙支付 商户支付功能接口规范 版本号1.0 2008年7月14日 功能说明： 本接口主要目的是为了让商户商城系统接入天龙支付平台，能够在天龙支付平台中进行支付，用户支付后，天龙支付会在第一时间内通知商户。 接口商户是根据天龙支付的接口文档传递相关的请求参数到天龙支付平台，天龙支付平台验证参数后，会引导用户到相应的页面进行支付操作，用户成功填入支付信息后，天龙支付平台将用户的支付成功与失败状态通知商户。 接口商户可以在自己的页面带入一些附加信息，天龙支付平台在回调时将该信息原样返回。 本接口支持那些语言？本平台接口支持大部分web语言，比如ASP，PHP，ASPX，JSP 支付流程图 网关接口规范 网关接口提交参数： 商户向平台网关提交的参数 网关地址：/pay/gateway.asp 参数 参数说明参与签名类型备注UserId 商户ID 是 整型数字 必须（如何查看商户ID？） 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://开头的绝对网络地址，否则充值成功后，您将得不到状态地址。 提交信息结果 错误代码详见附录 接口提交示例：/pay/gataway.asp? P_UserId=2000P_OrderId=90898089890we8r098erewrP_CardId=S0989899809342343443P_CardPass=908932849P_FaceValue=10.00P_ChannelId=3P_Subject=MyPayP_Price=10.00P_Quantity=1P_Description=MyPayP_Notic=sometextP_PostKey=SDFS098KLJLKSJDFSKLJLKKLSFP_Result_url=/result.aspP_Notify_URL= /notify.asp 示例中：是平台地址，/result.asp是您用于接收充值报告的回调地址，当用户通过接口充值成功后，平台后台自动调用这个地址；/notify.asp是用户充值成功后点“去商户取货”的转向地址 充值状态回调/商户取货转向 参数说明 充值状态回调：用户通过本平台网关充值后，本平台接收到充值报告状态时，立即向您在提交网关参数中的P_Result_URL（充值状态回调地址），传递充值报告，您根据这个充值报告的状态，决定给是否给用户增加网站服务； 商户取货转向：在提交到API接口的时候，如果正确传递了P_Notify_URL参数，那么在商户充值成功后点“到商户取货”时，就自动转向到P_Notify_URL所指的地址，同时跟上以下参数表的所有参数。 以下是充值报告状态参数列表： 参数 参数说明参与签名类型备注UserId 商户ID 是 整型数字 必须 P_OrderId 商户订单号 是 字符串，最长32位 必须，在商户系统中保持唯一 P_CardId 卡类充值时的卡号 是 字符串，最长20位 卡类充值时必须，否则可为空 P_CardPass 卡