支付平台API接口规范.doc

软件API系统接口规范 -  PAGE 5 - API支付系统 支付功能接口规范 版本号1.0 2011年7月14日 功能说明： 本接口主要目的是为了让商户商城系统接入支付平台系统，能够利用支付平台系统接口进行支付，用户支付后，支付平台系统会在第一时间内通知商户。 接口商户是根据支付平台系统的接口文档传递相关的请求参数到支付平台系统，支付平台系统验证参数后，会引导用户到相应的页面进行支付操作，用户成功填入支付信息后，支付平台系统将用户的支付成功与失败状态通知商户。 接口商户可以在自己的页面带入一些附加信息，支付平台系统在回调时将该信息原样返回。 本接口支持那些语言？本平台接口支持大部分web语言，比如ASP，PHP，ASPX，JSP 支付流程图 网关接口规范 网关接口提交参数： 商户向平台网关提交的参数 网关地址： HYPERLINK http://平台地址/pay/gateway.asp http://平台地址/pay/gateway.asp 参数参数说明参与签名类型备注P_UserId商户ID是整型数字必须（如何查看商户ID？）P_OrderId商户订单号是字符串，最长32位必须，在商户系统中保持唯一P_CardId卡类充值时的卡号是字符串，最长20位卡类充值时必须，否则可为空P_CardPass卡类充值时的卡密是字符串，最长20位卡类充值时必须，否则可为空P_FaceValue面值是float，保留2位小数必须P_ChannelId充值类型是整型数字必须( HYPERLINK \l 充值类型 具体参数详见附录)P_Subject产品名称否字符串，最常20位可为空P_Price产品价格否float，保留2位小数必须，可传0P_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必须填写，而且是 HYPERLINK http://开头的绝对网络地址 http://开头的绝对网络地址，否则充值成功后，您将得不到状态地址。 提交信息结果  HYPERLINK \l 错误代码 错误代码详见附录 接口提交示例：/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 示例中： HYPERLINK 是平台地址， HYPERLINK /result.asp /result.asp是您用于接收充值报告的回调地址，当用户通过接口充值成功后，平台后台自动调用这个地址； HYPERLINK /notify.asp /notify.asp是用户充值成功后点“去商户取货”的转向地址 充值状态回调/商户取货转向 参数说明 充值状态回调：用户通过本平台网关充值后，本平台接收到充值报告状态时，立即向您在提交网关参数中的P_Result_URL（充值状态回调地址），传递充值报告，您根据这个充值报告的状态，决定给是否给用户增加网站服务； 商户取货转向：在提交到API接口的时候，如果正确传递了P_Notify_URL参数，那么在