开发文档 - 雲雾易支付 - 行业领先的免签约支付平台

快速开始

欢迎使用雲雾易支付支付接口。本文档将帮助您快速完成支付功能的集成。

1

注册商户账号

前往注册页面完成商户注册，获取商户ID和密钥

2

配置支付参数

登录商户后台，设置支付密钥、异步通知地址等参数

3

调用API接口

按照下方文档调用支付接口，完成支付功能集成

API 接口

统一下单接口

POST /submit.php

向该接口提交支付参数，获取支付链接或二维码。

请求示例

POST /submit.php HTTP/1.1
Content-Type: application/x-www-form-urlencoded

pid=1001&type=alipay&out_trade_no=20240101001¬ify_url=https://example.com/notify&return_url=https://example.com/return&name=测试商品&money=1.00&sign=xxxxxxxx

响应示例

{
    "code": 1,
    "msg": "下单成功",
    "trade_no": "20240101000001",
    "payurl": "https://pay.example.com/pay/xxx"
}

参数说明

参数名	类型	必填	说明
`pid`	int	是	商户ID
`type`	string	是	支付方式：alipay / wxpay / qqpay
`out_trade_no`	string	是	商户订单号，需保证唯一
`notify_url`	string	是	异步通知地址
`return_url`	string	否	同步跳转地址
`name`	string	是	商品名称
`money`	string	是	支付金额（元），保留两位小数
`sitename`	string	否	网站名称
`sign`	string	是	签名，详见签名算法
`sign_type`	string	是	签名类型：MD5

签名算法

签名用于验证请求的合法性，防止数据被篡改。签名算法如下：

// 1. 将所有请求参数（除sign外）按参数名ASCII码从小到大排序
// 2. 拼接成 key=value&key=value... 格式
// 3. 在末尾拼接商户密钥 key
// 4. 计算 MD5 并转为大写

$sign = strtoupper(md5($paramStr . $key));

异步通知

支付成功后，系统会向 notify_url 发送 POST 请求通知支付结果。

// 通知参数
pid=1001&trade_no=20240101000001&out_trade_no=20240101001&type=alipay&name=测试商品&money=1.00&trade_status=TRADE_SUCCESS&sign=xxxxxxxx

// 收到通知后请返回 'success'（小写）确认接收

注意：系统会持续发送通知直到收到 success 响应，最多通知 5 次。

错误码

错误码	说明
`-1`	签名错误
`-2`	商户不存在
`-3`	支付方式不支持
`-4`	订单号重复
`-5`	金额格式错误

SDK 下载

我们提供以下语言的 SDK，帮助您快速接入：

PHP SDK Java SDK Python SDK Node.js SDK