API接口文档

接口概述

彩虹易支付提供标准的RESTful风格API接口。所有接口均采用HTTPS协议，请求方式为POST/GET，数据格式为JSON。开发者通过接口可实现支付下单、订单查询、退款申请、异步回调接收等完整支付流程。

• 接口域名：https://xxkkfz.cn/
• 编码格式：UTF-8
• 签名算法：MD5 / RSA-SHA256
• 数据格式：JSON

一、支付下单接口

商户系统向彩虹易支付发起支付请求，获取支付跳转URL或扫码链接。

请求地址

POST /api/submit.php

请求参数

• pid — 商户ID（必填）
• type — 支付方式：alipay / wxpay / qqpay / unionpay（必填）
• out_trade_no — 商户订单号，最长64位（必填）
• notify_url — 异步通知地址（必填）
• return_url — 同步跳转地址（必填）
• name — 商品名称，最长127位（必填）
• money — 支付金额，单位元，精确到分（必填）
• sign — MD5签名（必填）
• sign_type — 签名类型：MD5（必填）

签名算法

将所有请求参数（sign除外）按参数名ASCII码排序，拼接成 key1=value1&key2=value2 格式的字符串，末尾拼接商户密钥 &key=你的密钥，再计算MD5值：

$sign = md5($paramStr . $merchantKey);

PHP示例代码

<?php

$api_url = 'https://xxkkfz.cn/api/submit.php';

$params = [

    'pid'          => '1001',

    'type'         => 'alipay',

    'out_trade_no' => 'ORDER' . time(),

    'notify_url'   => 'https://你的域名/notify.php',

    'return_url'   => 'https://你的域名/return.php',

    'name'         => '测试商品',

    'money'        => '0.01',

];

$params['sign']      = md5(http_build_query($params) . '你的密钥');

$params['sign_type'] = 'MD5';



$ch = curl_init($api_url);

curl_setopt($ch, CURLOPT_POST, true);

curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);

curl_close($ch);

echo $response;

二、异步回调通知

支付成功后，彩虹易支付会向商户配置的 notify_url 发送POST请求通知支付结果。商户需验证签名后处理订单状态更新。

回调参数

• pid — 商户ID
• trade_no — 平台订单号
• out_trade_no — 商户订单号
• type — 支付方式
• name — 商品名称
• money — 支付金额
• trade_status — 交易状态：TRADE_SUCCESS 表示支付成功
• sign — 签名

验证签名后返回

echo 'success';

注意：商户必须在接收到通知后返回纯文本字符串 success，否则平台会持续重发通知（最多重试5次）。

三、订单查询接口

请求地址

POST /api/query.php

请求参数

• pid — 商户ID
• out_trade_no — 商户订单号
• sign — MD5签名

返回示例

{

  "code": 1,

  "msg": "查询成功",

  "data": {

    "trade_no": "202607170001",

    "out_trade_no": "ORDER001",

    "type": "alipay",

    "money": "100.00",

    "status": 1

  }

}

四、退款接口

请求地址

POST /api/refund.php

请求参数

• pid — 商户ID
• trade_no — 平台订单号
• money — 退款金额
• sign — MD5签名

五、SDK下载

以下为4种语言的SDK示例文件，包含完整签名算法和支付下单代码，直接下载即可集成：

SDK详细使用说明请参考上方接口文档和帮助中心相关教程。