yaovr-彩虹易支付 - 行业领先的免签约支付平台

协议规则

传输方式：HTTP

数据格式：JSON

签名算法：MD5

字符编码：UTF-8

页面跳转支付

此接口可用于用户前台直接发起支付，使用form表单跳转或拼接成url跳转。

URL地址：https://pay.yaovr.cn/submit.php

POST数据：pid={商户ID}&type={支付方式}&out_trade_no={商户订单号}&notify_url={服务器异步通知地址}&return_url={页面跳转通知地址}&name={商品名称}&money={金额}&sign={签名字符串}&sign_type=MD5

请求参数说明：

字段名	变量名	必填	类型	示例值	描述
商户ID	pid	是	Int	1001
支付方式	type	是	String	alipay	支付方式列表
商户订单号	out_trade_no	是	String	20160806151343349
异步通知地址	notify_url	是	String	http://www.pay.com/notify_url.php	服务器异步通知地址
跳转通知地址	return_url	是	String	http://www.pay.com/return_url.php	页面跳转通知地址
商品名称	name	是	String	VIP会员
商品金额	money	是	String	1.00
业务扩展参数	param	否	String	没有请留空	支付后原样返回
签名字符串	sign	是	String	202cb962ac59075b964b07152d234b70	签名算法点此查看
签名类型	sign_type	是	String	MD5	默认为MD5

API接口支付

此接口可用于服务器后端发起支付请求，会返回支付二维码链接或支付跳转url。

URL地址：https://pay.yaovr.cn/mapi.php

POST数据：pid={商户ID}&type={支付方式}&out_trade_no={商户订单号}&notify_url={服务器异步通知地址}&return_url={页面跳转通知地址}&name={商品名称}&money={金额}&clientip={用户IP地址}&device={设备类型}&sign={签名字符串}&sign_type=MD5

请求参数说明：

字段名	变量名	必填	类型	示例值	描述
商户ID	pid	是	Int	1001
支付方式	type	是	String	alipay	支付方式列表
商户订单号	out_trade_no	是	String	20160806151343349
异步通知地址	notify_url	是	String	http://www.pay.com/notify_url.php	服务器异步通知地址
跳转通知地址	return_url	否	String	http://www.pay.com/return_url.php	页面跳转通知地址
商品名称	name	是	String	VIP会员
商品金额	money	是	String	1.00
用户IP地址	clientip	是	String	192.168.1.100	用户发起支付的IP地址
设备类型	device	否	String	pc	根据当前用户浏览器的UA判断，传入用户所使用的浏览器或设备类型，默认为pc 设备类型列表
业务扩展参数	param	否	String	没有请留空	支付后原样返回
签名字符串	sign	是	String	202cb962ac59075b964b07152d234b70	签名算法点此查看
签名类型	sign_type	是	String	MD5	默认为MD5

返回结果（json）：

字段名	变量名	类型	示例值	描述
返回状态码	code	Int	1	1为成功，其它值为失败
返回信息	msg	String		失败时返回原因
订单号	trade_no	String	20160806151343349	支付订单号
支付跳转url	payurl	String	https://pay.yaovr.cn/pay/wxpay/202010903/	如果返回该字段，则直接跳转到该url支付
二维码链接	qrcode	String	weixin://wxpay/bizpayurl?pr=04IPMKM	如果返回该字段，则根据该url生成二维码
小程序跳转url	urlscheme	String	weixin://dl/business/?ticket=xxx	如果返回该字段，则使用js跳转该url，可发起微信小程序支付

注：payurl、qrcode、urlscheme 三个参数只会返回其中一个

支付结果通知

通知类型：服务器异步通知（notify_url）、页面跳转通知（return_url）

请求方式：GET

请求参数说明：

字段名	变量名	必填	类型	示例值	描述
商户ID	pid	是	Int	1001
易支付订单号	trade_no	是	String	20160806151343349021	yaovr-彩虹易支付订单号
商户订单号	out_trade_no	是	String	20160806151343349	商户系统内部的订单号
支付方式	type	是	String	alipay	支付方式列表
商品名称	name	是	String	VIP会员
商品金额	money	是	String	1.00
支付状态	trade_status	是	String	TRADE_SUCCESS	只有TRADE_SUCCESS是成功
业务扩展参数	param	否	String
签名字符串	sign	是	String	202cb962ac59075b964b07152d234b70	签名算法与支付宝签名算法相同
签名类型	sign_type	是	String	MD5	默认为MD5

收到异步通知后，需返回success以表示服务器接收到了订单通知

MD5签名算法

请对参数按照键名进行降序排序（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为小写

支付方式列表

调用值	显示名称
alipay	支付宝
wxpay	微信支付
qqpay	QQ钱包
bank	网银支付
jdpay	京东支付
paypal	PayPal
usdt	USDT
vmq	V免签

设备类型列表

调用值	显示名称
pc	电脑
mobile	手机浏览器
qq	手机QQ内浏览器
wechat	微信内浏览器
alipay	支付宝客户端

[API]查询商户信息

URL地址：https://pay.yaovr.cn/api.php?act=query&pid={商户ID}&key={商户密钥}

请求参数说明：

字段名	变量名	必填	类型	示例值	描述
操作类型	act	是	String	query	此API固定值
商户ID	pid	是	Int	1001
商户密钥	key	是	String	89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i

返回结果：

字段名	变量名	类型	示例值	描述
返回状态码	code	Int	1	1为成功，其它值为失败
商户ID	pid	Int	1001	所创建的商户ID
商户密钥	key	String(32)	89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i	所创建的商户密钥
商户状态	active	Int	1	1为正常，0为封禁
商户余额	money	String	0.00	商户所拥有的余额
结算方式	type	Int	1	1:支付宝,2:微信,3:QQ,4:银行卡
结算账号	account	String	admin@pay.com	结算的支付宝账号
结算姓名	username	String	张三	结算的支付宝姓名
订单总数	orders	Int	30	订单总数统计
今日订单	order_today	Int	15	今日订单数量
昨日订单	order_lastday	Int	15	昨日订单数量

[API]查询结算记录

URL地址：https://pay.yaovr.cn/api.php?act=settle&pid={商户ID}&key={商户密钥}

请求参数说明：

字段名	变量名	必填	类型	示例值	描述
操作类型	act	是	String	settle	此API固定值
商户ID	pid	是	Int	1001
商户密钥	key	是	String	89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i

返回结果：

字段名	变量名	类型	示例值	描述
返回状态码	code	Int	1	1为成功，其它值为失败
返回信息	msg	String	查询结算记录成功！
结算记录	data	Array	结算记录列表

[API]查询单个订单

URL地址：https://pay.yaovr.cn/api.php?act=order&pid={商户ID}&key={商户密钥}&out_trade_no={商户订单号}

请求参数说明：

字段名	变量名	必填	类型	示例值	描述
操作类型	act	是	String	order	此API固定值
商户ID	pid	是	Int	1001
商户密钥	key	是	String	89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i
系统订单号	trade_no	选择	String	20160806151343312
商户订单号	out_trade_no	选择	String	20160806151343349

提示：系统订单号和商户订单号二选一传入即可，如果都传入以系统订单号为准！

返回结果：

字段名	变量名	类型	示例值	描述
返回状态码	code	Int	1	1为成功，其它值为失败
返回信息	msg	String	查询订单号成功！
易支付订单号	trade_no	String	2016080622555342651	yaovr-彩虹易支付订单号
商户订单号	out_trade_no	String	20160806151343349	商户系统内部的订单号
支付方式	type	String	alipay	支付方式列表
商户ID	pid	Int	1001	发起支付的商户ID
创建订单时间	addtime	String	2016-08-06 22:55:52
完成交易时间	endtime	String	2016-08-06 22:55:52
商品名称	name	String	VIP会员
商品金额	money	String	1.00
支付状态	status	Int	0	1为支付成功，0为未支付
业务扩展参数	param	String		默认留空
支付者账号	buyer	String		默认留空

[API]批量查询订单

URL地址：https://pay.yaovr.cn/api.php?act=orders&pid={商户ID}&key={商户密钥}

请求参数说明：

字段名	变量名	必填	类型	示例值	描述
操作类型	act	是	String	orders	此API固定值
商户ID	pid	是	Int	1001
商户密钥	key	是	String	89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i
查询订单数量	limit	否	Int	20	返回的订单数量，最大50
页码	page	否	Int	1	当前查询的页码

返回结果：

字段名	变量名	类型	示例值	描述
返回状态码	code	Int	1	1为成功，其它值为失败
返回信息	msg	String	查询结算记录成功！
订单列表	data	Array		订单列表

SDK下载

SDK.zip
SDK版本：V1.2