接口说明及规范

协议规则

项目	说明
提交数据格式	`application/x-www-form-urlencoded`
返回数据格式	`JSON`
字符编码	`UTF-8`
签名算法	`SHA256WithRSA`

接口地址

API接口基础地址：https://pro.cyyidc.cc/

获取RSA密钥对

在商户后台 → 个人资料 → API信息页面，点击【生成商户RSA密钥对】，生成后注意保存【商户私钥】。

对接接口时只需要用到【平台公钥】与【商户私钥】。

V2升级说明

V2接口全面使用 RSA 签名算法；V1接口使用 MD5 签名算法
V2接口改用全新的接口地址，支持退款、代付等功能
V2接口新增timestamp入参和返回值用于校验时间戳

签名规则

签名步骤

将所有参数按照参数名ASCII码从小到大排序
将排序后的参数拼接成 key1=value1&key2=value2 格式
使用商户私钥对拼接字符串进行SHA256WithRSA签名
将签名结果进行Base64编码

签名示例（PHP）

function sign($data, $privateKey) {
    ksort($data);
    $str = http_build_query($data);
    openssl_sign($str, $signature, $privateKey, OPENSSL_ALGO_SHA256);
    return base64_encode($signature);
}

注意：签名时需排除 sign 参数本身，空值参数不参与签名。

支付方式列表

以下是平台当前支持的支付方式及其调用值：

调用值(type)	支付方式名称
alipay	支付宝-H5
wxpay	微信支付-H5
qqpay	QQ钱包-扫码
bank	银联云闪付-H5
jdpay	京东支付-H5
default	个人码支付-扫码

具体可用的支付方式以商户后台显示为准，不同商户可能有不同的支付权限。

页面跳转支付

通过表单POST方式跳转到支付页面完成支付。

请求地址

POST /submit.php

请求参数

参数	必填	说明
pid	是	商户ID
type	是	支付方式
out_trade_no	是	商户订单号
notify_url	是	异步通知地址
return_url	是	同步跳转地址
name	是	商品名称
money	是	金额（元）
timestamp	是	时间戳
sign	是	签名

统一下单接口

通过API方式创建支付订单，获取支付链接。

请求地址

POST /api/pay/create

请求参数

参数	必填	说明
pid	是	商户ID
type	是	支付方式
out_trade_no	是	商户订单号
notify_url	是	异步通知地址
name	是	商品名称
money	是	金额（元）
timestamp	是	时间戳
sign	是	签名

返回参数

参数	说明
code	状态码，1=成功
msg	提示信息
trade_no	平台订单号
payurl	支付链接
qrcode	二维码内容

订单查询

查询订单的支付状态。

请求地址

POST /api/pay/query

请求参数

参数	必填	说明
pid	是	商户ID
out_trade_no	是	商户订单号
timestamp	是	时间戳
sign	是	签名

返回参数

参数	说明
code	状态码，1=成功
status	订单状态：0=待支付，1=已支付
trade_no	平台订单号
money	订单金额

订单退款

对已支付的订单发起退款申请。

请求地址

POST /api/pay/refund

请求参数

参数	必填	说明
pid	是	商户ID
trade_no	是	平台订单号
money	是	退款金额
timestamp	是	时间戳
sign	是	签名

返回参数

参数	说明
code	状态码，1=成功
msg	提示信息
refund_no	退款单号

订单退款查询

查询退款订单的处理状态。

请求地址

POST /api/pay/refundquery

请求参数

参数	必填	说明
pid	是	商户ID
refund_no	是	退款单号
timestamp	是	时间戳
sign	是	签名

返回参数

参数	说明
code	状态码，1=成功
status	退款状态：0=处理中，1=已退款，2=退款失败
money	退款金额

支付结果通知

用户支付成功后，平台会向商户设置的notify_url发送POST通知。

通知参数

参数	说明
pid	商户ID
trade_no	平台订单号
out_trade_no	商户订单号
type	支付方式
name	商品名称
money	订单金额
trade_status	交易状态：TRADE_SUCCESS
timestamp	时间戳
sign	签名

收到通知后请返回 success 字符串，否则平台会重复通知。

查询商户信息

查询商户账户余额等信息。

请求地址

POST /api/merchant/info

请求参数

参数	必填	说明
pid	是	商户ID
timestamp	是	时间戳
sign	是	签名

查询订单列表

查询商户的订单列表。

请求地址

POST /api/merchant/orders

请求参数

参数	必填	说明
pid	是	商户ID
page	否	页码，默认1
limit	否	每页数量，默认20
timestamp	是	时间戳
sign	是	签名

转账发起

发起转账/代付请求，将资金转入指定账户。

请求地址

POST /api/transfer/submit

请求参数

参数	必填	说明
pid	是	商户ID
out_trade_no	是	商户转账单号
money	是	转账金额
account_type	是	账户类型：alipay/wechat/bank
account	是	收款账号
account_name	是	收款人姓名
timestamp	是	时间戳
sign	是	签名

返回参数

参数	说明
code	状态码，1=成功
msg	提示信息
transfer_no	平台转账单号

转账查询

查询转账订单的处理状态。

请求地址

POST /api/transfer/query

请求参数

参数	必填	说明
pid	是	商户ID
out_trade_no	是	商户转账单号
timestamp	是	时间戳
sign	是	签名

返回参数

参数	说明
code	状态码，1=成功
status	转账状态：0=处理中，1=已完成，2=失败
money	转账金额

可用余额查询

查询商户账户可用于转账的余额。

请求地址

POST /api/transfer/balance

请求参数

参数	必填	说明
pid	是	商户ID
timestamp	是	时间戳
sign	是	签名

返回参数

参数	说明
code	状态码，1=成功
balance	可用余额
freeze	冻结金额

SDK下载

我们提供多种语言的SDK，帮助您快速接入支付功能。

PHP SDK

适用于PHP 7.0及以上版本，支持Composer安装。

Java SDK

适用于Java 8及以上版本，支持Maven依赖。

Python SDK

适用于Python 3.6及以上版本，支持pip安装。

如需SDK请联系客服获取或登录商户后台下载。