网关接口提交参数

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

网关地址:https://pay.ctwo.io/Payapi_Index_Pay.html

参数

参数说明

参与签名

类型

备注

P_UserId

商户ID

整型数字

必须

P_OrderId

商户订单号

字符串,最长32

必须,在商户系统中保持唯一

P_CardId

卡类充值时的卡号

字符串,最长20

可为空,卡类充值时为必须

P_CardPass

卡类充值时的卡密

字符串,最长20

可为空,卡类充值时为必须

P_FaceValue

面值/订单支付金额

float,保留8位小数

必须

P_ChannelId

支付币种

整型数字

必须(具体参数详见附录)

P_Subject

产品名称

字符串,最常20

可为空

P_Price

产品价格

float,保留2位小数

可为空

P_Quantity

产品数量

整型数字

可为空

P_Description

产品描述

字符串,最常100

可为空

P_Notic

用户附加信息

字符串,最常50

可为空

P_Result_URL

充值状态通知地址

字符串,最长100

必须

P_Notify_URL

充值后网页跳转地址

字符串,最长100

可为空

P_PostKey

签名认证串

字符串

必须

说明:

(a) 签名认证postKey的生成:必须按照“参与签名”状态为“是”的参数按其顺序用“|”组合,最后加上用户密钥,然后进行32位的md5编码,比如:P_PostKey=md5_32(P_UserId|P_OrderId|P_CardId|P_CardPass|P_FaceValue|P_ChannelId|SalfStr),SalfStr是您申请商户通过之后,在接口信息里面的密钥。)

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

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

(d) 接口提交示例:https://pay.ctwo.io/Payapi_Index_Pay.html?P_UserId=10297&P_OrderId=1484424249&P_CardId=&P_CardPass=&P_FaceValue=0.01&P_ChannelId=7&P_Subject=99888899&P_Price=&P_Quantity=&P_Description=&P_Notic=&P_Result_url=https://pay.ctwo.io/PayApi/Result_url.php&P_Notify_url=https://pay.ctwo.io/PayApi/Notify_Url.php&P_PostKey=db2c182d6ab80bef8019b0c0cba70895

注意:P_Subject、P_Price、P_Quantity、P_Description、P_Notic、 这五个参数最后会放在一块变成一个参数随着充值状态返回,所以如果是常见的返回某个在商户网站用户账户的值,建议只要给这五个参数中的一个赋值,其余四个空着就行,例如上面的接口示例链接中:(P_Subject=99888899&P_Price=&P_Quantity=&P_Description=&P_Notic=),支付成功即会返回一个99888899的用户名参数;

(e) 示例中:https://pay.ctwo.io/Payapi_Index_Pay.html是平台API网关提交的地址,https://pay.ctwo.io/PayApi/Result_url.php是您后端用于接收充值报告的回调地址,当用户通过接口充值成功后,平台后台自动调用这个地址;而https://pay.ctwo.io/PayApi/Notify_Url是用户充值成功后点“去商户取货”的转向地址

(f) 支付接口在线demo测试入口:支付接口测试