默认发起付款接口
注意:所有参数和返回值均使用“utf-8”编码。
注意:后台-接口信息,可切换易支付接口或默认接口。
支付请求地址接口URL:
https://pay.iermei.com
发起支付传参方式API:POST/GET
请求参数:
# | 参数名 | 含义 | 类型 | 说明 |
---|---|---|---|---|
1 | pid | 商户PID | string | 必填。(商户后台获取) |
2 | type | 支付类型 | string | 必填。(alipay:支付宝,wxpay:微信支付,qqpay:QQ支付) |
3 | record | 附加参数 | string | 必填。(可传入您网站的订单号或用户名等唯一参数) |
4 | money | 订单金额 | float(2) | 必填。(1.00) |
5 | refer | 同步回调 | string | 必填。(页面转跳通知地址) |
6 | notify | 异步回调 | string | 必填。(服务器异步通知地址) |
7 | mid | 收款账号MID | string | 可忽略。(为空则随机轮询账号) |
8 | json | json=1 | string | 可忽略。(返回JSON格式输出,为空直接转跳支付页面) |
9 | sign | 数据签名 | string | 必填。(签名方法见下文) |
注意:1、创建订单时如果同一个订单(string)、相同金额(money)、相同支付渠道( type)且未支付未过期的订单,那么继续使用这个订单(用户多次点击付款订单金额不会变化,减少二维码占用)。注意设置string,避免串单。
注意:2、接口密钥KEY在安全上非常重要,一定不要显示在任何网页代码、网址参数中。只可以放在服务端。计算sign时,先在服务端计算好,把计算出来的sign传出来。严禁在客户端计算sign,严禁在客户端存储接口密钥。
关于返回“支付通道忙”:1、没有上传与支付渠道(type)相同类型且符合金额的二维码;2、所有的可用的二维码被其他未支付的订单占用。
支付类型列表:
# | 名称 | 代码 | 类型 | 说明 |
---|---|---|---|---|
1 | mq_gqqjkd | 扫码 | 监控端 | |
2 | mq_gqqyd | 扫码 | 云端 | |
3 | mq_gqqyjk | 扫码 | 云监控 | |
4 | 微信 | mq_gvxjkd | 扫码 | 监控端 |
5 | 微信 | mq_gvxyd | 扫码 | 云端 |
6 | 微信 | mq_gvxyjk | 扫码 | 云监控 |
7 | 易支付 | mq_gyzf | 扫码/转账 | |
8 | 支付宝 | mq_gzfbjkd | 扫码 | 监控端 |
9 | 支付宝 | mq_gzfbyd | 扫码 | 云端 |
10 | 支付宝 | mq_gzfbyjk | 扫码 | 云监控 |
11 | 支付宝-当面付 | zfb_dmf | 扫码 | 监控端 |
12 | 支付宝-转账 | mq_gzfbzzjkd | 扫码 | 监控端 |
13 | 快手 | ks_mck | 扫码 | 微信内付专用 |
14 | 快手直播 | ks_kb_mck | 扫码 | 免CK |
15 | 快手小店 | ks_xd_bzj | 扫码 | 保证金 |
16 | 抖音直播 | dy_db | 扫码 | 抖币 |
17 | 轻语 | qingyuu | 扫码 | 新版 |
18 | 比心陪玩 | bx_mck | 扫码 | 免CK |
19 | 95秀直播 | jwxzb | 扫码 | CK |
20 | 新虎牙币 | xhy_hb | 扫码 | CK |
21 | USDT | usdt | 转账 | |
22 | Y币充值 | yy_zb | 扫码 | h5免CK |
23 | 哔哩哔哩(B币) | bibi_dc | 扫码 |
如果支付页接口URL后面加“?format=json”参数,那么返回结果就是 json 格式的,此方式需要开发者自己展示付款二维码
数据签名算法:
请对参数按照键名进行降序排序(a-z),sign 和空值不进行签名! 排序后请操作参数生成或拼接一个url请求字符串 例如 a=b&c=d&e=f (Url值不能携带参数!不要进行urlencode) 再将拼接好的请求字符串与平台生成的Key进行MD5加密得出sign签名参数 md5 ( a=b&c=d&e=f + KEY ) (注意:+ 为各语言的拼接符!不是字符!),md5为小写 $api = array( "pid" => $api['pid'],//商户ID "type" => $api['type'],//支付方式 "record"=> $api['record'],//附加参数 "money" => $api['money'],//付款金额 "refer" => $api['refer'],//同步跳转地址 "notify" => $api['notify'],//异步通知地址 ); ksort($api); //排序GET和POST参数 reset($api); //内部指针指向数组中的第一个元素 $sign = '';//初始化 foreach ($api AS $key => $val) { //遍历附加参数 if ($val == '' || $key == 'sign') continue; //跳过这些不签名 if ($sign) $sign .= '&'; //第一个字符串签名不加& 其他加&连接起来参数 $sign .= "$key=$val"; //拼接为url参数形式 } $sign_ok = md5($sign . 您的商户密匙KEY);//md5加密参数
付款成功异步通知
用户付款成功后,我们会向接口的 异步通知网址 发送通知。您的服务器需返回“success”,就表示回调已收到,返回数据不要包含任何其它HTML代码。如果返回其它数据,会再通知5次。
传参方式:Post
参数内容:
# | 参数名 | 含义 | 类型 | 说明 |
---|---|---|---|---|
1 | type | 支付类型 | string | alipay:支付宝,wxpay:微信支付,qqpay:QQ支付 |
2 | money | 订单金额 | float(2) | 金额:1.00 |
3 | order | 云端订单号 | string | 支付平台创建的云端订单号 |
4 | record | 附加参数 | string | 发起支付传递的您网站的订单号或用户名等唯一参数 |
5 | sign | 数据签名 | string | 签名算法与支付宝签名算法相同 |
注意:建议将发货的操作放在此页面下。
付款成功同步跳转
用户付款成功后,我们会在先通过上面的接口,通知您服务器付款成功,再过1-2秒后将用户跳转到接口的 return_url 网址。
传参方式:Get
参数内容:
# | 参数名 | 含义 | 类型 | 说明 |
---|---|---|---|---|
1 | type | 支付类型 | string | alipay:支付宝,wxpay:微信支付,qqpay:QQ支付 |
2 | money | 订单金额 | float(2) | 金额:1.00 |
3 | order | 云端订单号 | string | 支付平台创建的云端订单号 |
4 | record | 附加参数 | string | 发起支付传递的您网站的订单号或用户名等唯一参数 |
5 | sign | 数据签名 | string | 签名算法与支付宝签名算法相同 |
注意:请不要将发货操作放在此页面下,用户提前关闭网页可能导致发货失败,此页面一般仅用于显示支付结果