接口文档

本平台接口完全兼容「彩虹易支付」协议，支持 页面跳转支付 与 API 接口支付 两种模式。接口地址：https://pay2.xueyuanpie.com/

商户号：1000 | 商户密钥：your_merchant_key（登录用户中心可查看完整密钥）

1. 页面跳转支付

用户在商户页面提交表单，浏览器跳转到平台收银台完成支付。提交地址：https://pay2.xueyuanpie.com/submit.php，请求方式 POST 或 GET。

参数	类型	必填	说明
pid	int	是	商户 ID
type	string	否	支付方式：alipay / wxpay / qqpay / bank，留空进入收银台选择
out_trade_no	string	是	商户订单号，仅限字母数字 - _ . \|
notify_url	string	是	异步通知地址
return_url	string	是	同步跳转地址
name	string	是	商品名称
money	decimal	是	金额，单位元，最多两位小数
param	string	否	业务扩展参数，回调原样返回
channel_id	int	否	指定支付通道 ID
sign	string	是	签名，算法见签名说明
sign_type	string	是	MD5 或 RSA

2. API 接口支付

服务端调用，返回 JSON 支付参数（二维码、跳转链接或 HTML）。提交地址：https://pay2.xueyuanpie.com/mapi.php，请求方式 POST。

除上表参数外，额外支持：

参数	类型	必填	说明
clientip	string	是	用户客户端 IP
device	string	否	pc / mobile / wechat / qq / alipay / jump
method	string	否	web / jump / jsapi / scan
sub_openid	string	否	JSAPI 支付时的用户 openid
sub_appid	string	否	JSAPI 支付时的公众号 / 小程序 AppID
auth_code	string	否	付款码支付时的授权码

成功返回示例：

{
  "code": 1,
  "trade_no": "2025010112000012345",
  "pay_type": "qrcode",
  "pay_info": "https://qr.alipay.com/xxxxx",
  "timestamp": "1735700000",
  "sign": "...",
  "sign_type": "RSA"
}

pay_type 取值：jump 跳转链接、qrcode 二维码内容、html 表单 HTML、jsapi 微信 JSAPI 参数、urlscheme 小程序跳转链接。

3. 订单查询

接口	地址	说明
单笔查询	`api.php?act=order`	参数 pid、key、trade_no 或 out_trade_no
批量查询	`api.php?act=orders`	参数 pid、key、limit、offset、status
商户信息	`api.php?act=query`	返回余额、订单统计等
结算记录	`api.php?act=settle`	参数 pid、key、limit、offset

示例：https://pay2.xueyuanpie.com/api.php?act=order&pid=1000&key=your_merchant_key&out_trade_no=ORDER_001

4. 订单退款

提交地址：https://pay2.xueyuanpie.com/api.php?act=refund，POST，参数 pid、key、trade_no（或 out_trade_no）、money。需在用户中心开启退款权限。

5. 错误码

code	说明
0 / 1	成功
-1	业务错误（订单不存在、金额不合法等）
-2	通道下单失败
-3	商户校验或签名失败
-4	缺少必要参数
-5	接口不存在