万亿支付商户支付功能接口规范文档.doc
文本预览下载声明
万亿支付 商户支付功能接口规范
版本号1.3
深圳联商通科技有限公司
/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 卡类充值时的卡密 是 字符串,最长20位 卡类充值时必须,否则可为空 P_FaceValue 面值 是 float,保留2位小数 必须 P_ChannelId 充值类型 是 整型数字 必须(具体参数详见附录) P_PayMoney 实际充值金额 否 float,保留2位小数 必须 P_Subject 产品名称 否 字符串,最常20位 可为空 P_Price 产品价格 否 float,保留2位小数 必须,可传0 P_Quantity 产品数量 否 整型数字 必须 P_Description 产品描述 否 字符串,最常100位 可为空 P_Notic 用户附加信息 否 字符串,最常50位 可为空 P_ErrCode 错误代码
显示全部