易支付发起付款接口
注意:所有参数和返回值均使用“utf-8”编码。
注意:后台-接口信息,可切换易支付接口或默认接口。
支付请求地址接口URL:
https://pay.iermei.com
POST数据:
pid={商户ID}&type={支付方式}&out_trade_no={商户订单号}¬ify_url={服务器异步通知地址}&return_url={页面跳转通知地址}&name={商品名称}&money={金额}&sitename={网站名称}&sign={签名字符串}&sign_type=MD5
发起支付传参方式API:POST/GET
请求参数:
# | 参数名 | 含义 | 类型 | 说明 |
---|---|---|---|---|
1 | pid | 商户PID | Int | 必填。(商户后台获取) |
2 | type | 支付类型 | String | 必填。(alipay:支付宝,wxpay:微信支付,qqpay:QQ支付) |
3 | out_trade_no | 商户订单号 | String | 必填。(20160806151343349) |
4 | name | 商品名称 | String | 必填。(VIP会员) |
5 | money | 订单金额 | String | 必填。(1.00) |
6 | return_url | 同步回调 | String | 必填。(页面转跳通知地址) |
7 | notify_url | 异步回调 | String | 必填。(服务器异步通知地址) |
8 | sitename | 网站名称 | String | 可忽略。(爱尔美科技自定义) |
9 | param | 业务扩展叁数 | String | 可忽略。(没有请留空) |
10 | mid | 收款账号MID | String | 可忽略。(为空则随机轮询账号) |
11 | json | json=1 | String | 可忽略。(返回JSON格式输出,为空直接转跳支付页面) |
12 | sign | 签名字符串 | String | 必填。签名字符串,签名算法与支付宝签名算法相同(请对参数按照键名进行降序排序(a-z),sign sign_type 和空值不进行签名!。 排序后请操作参数生成或拼接一个url请求字符串 例如 a=b&c=d&e=f (Url值不能携带参数!不要进行urlencode) 再将拼接好的请求字符串与平台生成的Key进行MD5加密得出sign签名参数 md5 ( a=b&c=d&e=f + KEY ) (注意:+ 为各语言的拼接符!不是字符!),md5为小写)202cb962ac59075b964b07152d234b70 |
13 | sign_type | 签名类型 | String | 必填。默认为MD5 |
注意:1、创建订单时如果同一个用户(out_trade_no)存在相同商品(name)、相同金额(money)、相同支付渠道( type)且未支付未过期的订单,那么继续使用这个订单(用户多次点击付款订单金额不会变化,减少二维码占用)。注意设置out_trade_no,避免串单。
注意: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 格式的,此方式需要开发者自己展示付款二维码
付款成功异步通知
用户付款成功后,我们会向接口的 异步通知网址 发送通知。您的服务器需返回“success”,就表示回调已收到,返回数据不要包含任何其它HTML代码。如果返回其它数据,会再通知5次。
传参方式:Post
参数内容:
# | 参数名 | 含义 | 类型 | 说明 |
---|---|---|---|---|
1 | pid | 商户PID | String | 商户后台获取,原路返回。 |
2 | trade_no | 平台订单号 | String | 平台自动生成的订单号(20160806151343349021) |
3 | out_trade_no | 商户订单号 | String | 商户自己的订单号,请确保唯一。(20160806151343349) |
4 | type | 支付类型 | String | alipay:支付宝,wxpay:微信支付,qqpay:QQ支付 |
5 | name | 商品名称 | String | 比如:VIP会员。和请求时一样,原样返回 |
6 | money | 订单金额 | float(2) | 金额:1.00 |
6 | trade_status | 支付状态 | String | 只有SUCCESS是成功 |
7 | param | 业务扩展叁数 | String | 没有则不传出该叁数 |
8 | sign | 数据签名 | String | 签名算法与支付宝签名算法相同 |
9 | sign_type | MD5 | String | 默认为MD5 |
注意:建议将发货的操作放在此页面下。
付款成功同步跳转
用户付款成功后,我们会在先通过上面的接口,通知您服务器付款成功,再过1-2秒后将用户跳转到接口的 return_url 网址。
传参方式:Get
参数内容:
# | 参数名 | 含义 | 类型 | 说明 |
---|---|---|---|---|
1 | pid | 商户PID | String | 商户后台获取,原路返回。 |
2 | trade_no | 平台订单号 | String | 平台自动生成的订单号(20160806151343349021) |
3 | out_trade_no | 商户订单号 | String | 商户自己的订单号,请确保唯一。(20160806151343349) |
4 | type | 支付类型 | String | alipay:支付宝,wxpay:微信支付,qqpay:QQ支付 |
5 | name | 商品名称 | String | 比如:VIP会员。和请求时一样,原样返回 |
6 | money | 订单金额 | float(2) | 金额:1.00 |
6 | trade_status | 同步回调 | String | 只有SUCCESS是成功 |
7 | param | 业务扩展叁数 | String | 没有则不传出该叁数 |
8 | sign | 数据签名 | String | 签名算法与支付宝签名算法相同 |
9 | sign_type | MD5 | String | 默认为MD5 |
注意:请不要将发货操作放在此页面下,用户提前关闭网页可能导致发货失败,此页面一般仅用于显示支付结果