协议规则

请求数据格式：application/x-www-form-urlencoded

返回数据格式：JSON

签名算法：MD5

字符编码：UTF-8

页面跳转支付

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

URL地址：https://www.cypay.today/submit.php

请求方式：POST 或 GET（推荐HTTPS + POST；POST本身不提供加密）

请求参数说明：

channel_id必须传入并参与签名；缺失、未授权、关闭、超出金额范围均拒绝，不随机切换通道。

API接口支付

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

URL地址：https://www.cypay.today/mapi.php

请求方式：POST

请求参数说明：

返回结果（json）：

成功不表示已付款。通常返回payurl、qrcode、urlscheme中的一种，部分插件返回html表单；须按实际字段处理。非1的code均按失败处理并记录msg。

支付结果通知

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

请求方式：GET

请求参数说明：

异步通知必须先验签、核对商户/订单/金额/成功状态并幂等处理，再返回success。回调不新增channel_id，按out_trade_no关联原通道；页面跳转不能当作付款凭证。

MD5签名算法

1、将发送或接收到的所有参数按照参数名ASCII码从小到大排序（a-z），sign、sign_type、和空值不参与签名！

2、将排序后的参数拼接成URL键值对的格式，例如 a=b&c=d&e=f，参数值不要进行url编码。

3、再将拼接好的字符串与商户密钥KEY进行MD5加密得出sign签名参数，sign = md5 ( a=b&c=d&e=f + KEY ) （注意：+ 为各语言的拼接符，不是字符！），md5结果为小写。

4、现有SDK必须把channel_id加入参数并参与签名后才能使用。字段为字符串，不能转换成数字；所有非空业务参数参与签名。

支付方式列表

设备类型列表

[API]查询商户信息

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

请求参数说明：

返回结果：

[API]查询结算记录

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

请求参数说明：

返回结果：

[API]查询单个订单

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

请求参数说明：

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

返回结果：

[API]批量查询订单

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

请求参数说明：

返回结果：

[API]提交订单退款

需要先在商户后台开启订单退款API接口开关，才能调用该接口发起订单退款

URL地址：https://www.cypay.today/api.php?act=refund

请求方式：POST

请求参数说明：

注：trade_no、out_trade_no 不能同时为空，如果都传了以trade_no为准

返回结果：

SDK下载

下载新版PHP签名示例与对接说明
这是服务端请求生成示例，不是完整SDK，不会自动发起支付。旧V1.3 SDK需新增channel_id并参与签名后才能使用。