直连开发文档发起支付API


1.请求方式:GET/POST
2.提交网址:https://www.5youpay.com/5youpay
3.请求参数:
参数名称 参数变量 类型长度 说明
商户ID pid int(8) 商户ID 在后台获取,实例:1001
订单编号号 out_trade_no varchar(20) 商户自定义生成,必须确保唯一性
订单金额 money decimal(18,2) 精确到小数点后两位,例如1.00
支付通道 type varchar(10) 请看下面支付通道代码说明
异步通知URL notify_url varchar(50) 不能带有任何参数,付款成功后发送通知
同步跳转URL return_url varchar(50) 不能带有任何参数,付款成功后跳转到此页面
订单名称 name varchar(50) 商户自定义 如:XX商品
网站名称 sitename varchar(50) 商户自定义可用于,如:无忧充值接口对接平台
MD5签名 sign varchar(32) 必填,请看下方说明,拼接url参数加上Key后md5加密

提交MD5签名方法


将接口中实际全部上送的字段,按照字段名的 ASCII 码从小到大排序后(字典序), 剔除 sign 字段,剔除 sign_type 字段和剔除值为空的参数,使用 URL 键值对的格式(即 key1=value1&key2=value2…)拼接成字符串 string1。

以下为实例PHP生成MD5:
$type='tenpay';//这个是发起财付通支付样式
$parameter = array(
"pid" => '220151',//这个是商户ID改成自己的
"type" => $type,
"notify_url" => 'www.5youpay.com/notify_url.php',//异步通知,改为自己的
"return_url" => 'www.5youpay.com/return_url.php',,//同步跳转,改成自己的
"out_trade_no" => $out_trade_no,//订单号
"name" =>'充值-' . $total_amount,
"money" => $total_amount,//订单价格
"sitename" => '充值-' . $total_amount
);
ksort($parameter);
reset($parameter);
$sign = '';
$urls = '';
foreach ($parameter AS $key => $val) {
if ($val == '' || $key == 'sign') continue;
if ($sign != '') {
$sign .= "&";
$urls .= "&";
}
$sign .= "$key=$val";
}
$mch_key ='eu4y6sYMbY66nYgenD0NbJ68E0MFeeNY';//商户key
$sign=md5($sign .$mch_key .$mch_key);



支付通道代码说明


# 支付方式 通道代码 说明
1 支付宝 alipay 支付宝支付
2 微信支付 wxpay 微信支付
3 QQ钱包 qqpay QQ钱包支付
3 财付通 tenpay 财付通支付

异步回调 服务器异步通知(notify_url)


1.通知方式:GET
2.收到请回:success,如未收到success,我们将5分钟之后再次发送通知,最多主动通知4次,
也就是在20分钟之内通知4次,请商户必须正确处理重复的通知。
3.参数说明:
参数名称 参数变量 类型长度 说明
状态 trade_status varchar(10) TRADE_SUCCESS成功,fail失败
商户ID pid int(8) 订单对应的商户ID
商户订单号 out_trade_no varchar(20) 商户自定义生成的订单号
无忧平台订单号 trade_no varchar(20) 本平台的订单号
订单金额 money decimal(18,2) 支付金额
支付通道 type varchar(10) 支付通道代码
订单名称 name varchar(50) 支付订单的名称
MD5签名 sign varchar(32) 参照下方通知MD5签名
签名类型 sign_type varchar(32) 默认为MD5,请具体看下方通知MD5加密验证方法

同步回调 页面跳转通知(return_url)


1.通知方式:GET 付款成功后跳转到此页面
2.参数说明:
参数名称 参数变量 类型长度 说明
状态 trade_status varchar(10) TRADE_SUCCESS成功,fail失败
商户ID pid int(8) 订单对应的商户ID
商户订单号 out_trade_no varchar(20) 商户自定义生成的订单号
无忧平台订单号 trade_no varchar(20) 本平台的订单号
订单金额 money decimal(18,2) 支付金额
支付通道 type varchar(10) 支付通道代码
订单名称 name varchar(50) 支付订单的名称
MD5签名 sign varchar(32) 参照下方通知MD5签名
签名类型 sign_type varchar(32) 默认为MD5,请具体看下方通知MD5加密验证方法

检查通知MD5签名方法,防止被伪造!


if (empty($_GET)) {
$_GET = $_POST;
}
ksort($_GET);//$_GET为我们平台返回的数据
reset($_GET);
$sign = '';
foreach ($_GET AS $key=>$val)
{
if ($key != 'sign' && $key != 'sign_type')
{
$sign .= "$key=$val&";
}
}
$sign = md5(substr($sign, 0, -1).$key);//$key为商户密钥,请在商户中心获取
将上面得到的sign和从无忧返回的MD5签名进行比较,如果一致可通过,不一致即为伪造信息。



在线
客服

在线客服QQ服务时间:9:00-23:00

客服
热线

0561—7224888
7*12小时客服服务热线

关注
微信

关注官方微信公众号
顶部