开发文档
佳梦云付对外接口兼容易支付协议标准。已有多数易支付生态的商户零改造迁移； 新接入的开发者按本文档 10 分钟可完成联调。
1. 接入概述
商户在商户中心注册后获得 商户号 pid 与 商户密钥 key。 支付流程：用户在商户站发起支付 → 商户服务端组装参数签名 → 跳转或请求提交接口 → 用户在收银台完成支付 → 平台异步通知商户 → 商户凭通知发货。
安全准则：一切以异步通知与服务端查询结果为准，同步回跳仅用于展示；密钥只保存在服务端，不要下发到前端。
2. 签名规则
将参与签名的参数按参数名 ASCII 码从小到大排序，以 k=v&k=v 拼接 （跳过空值、sign、sign_type），得到待签名串后直接拼接商户密钥，取 32 位小写 MD5。
待签名串 = "money=9.90&name=会员月卡¬ify_url=https://...&out_trade_no=SHOP123&pid=1000&type=sandbox_wechat"
sign = md5(待签名串 + 商户key)3. 支付提交
页面跳转式：/submit.php（GET/POST 表单，成功后 302 到收银台）； API 式：/mapi.php（返回 JSON，含收银台链接与二维码）。
| 参数名 | 必填 | 说明 |
|---|---|---|
| pid | 是 | 商户号，商户中心可查 |
| type | 是 | 支付渠道，如 sandbox_wechat / sandbox_alipay |
| out_trade_no | 是 | 商户订单号，1-64 位，商户内唯一 |
| notify_url | 是 | 异步通知地址，http(s):// |
| return_url | 否 | 支付完成后的同步回跳地址 |
| name | 是 | 商品名称，最长 100 字 |
| money | 是 | 金额（元），最多两位小数，如 9.90 |
| sign | 是 | 按签名规则计算，32 位小写 MD5 |
| sign_type | 是 | 固定值 MD5 |
mapi.php 返回：{code:1, payurl, qrcode, trade_no}，code 非 1 时以 msg 提示失败原因。
4. 异步通知（notify_url）
支付成功后，平台以 GET 方式携带以下参数请求 notify_url，商户验签通过并处理完成后输出success即表示送达；最多重试 5 次，也可在商户中心手动重发。
| 参数名 | 必填 | 说明 |
|---|---|---|
| payStatus | — | 固定 1，表示支付成功 |
| tradeNo | — | 平台订单号 |
| outTradeNo | — | 商户订单号 |
| name | — | 商品名称 |
| money | — | 金额（元） |
| param | — | 提交时透传的 param（如有） |
| sign | — | 签名，验签方式与提交一致 |
5. 同步回跳（return_url）
用户支付完成后浏览器将跳转 return_url，携带 outTradeNo、tradeNo、money、param、sign。 仅用于向用户展示结果，发货逻辑必须以异步通知或主动查询为准。
6. 订单查询
/api/pay/query（GET/POST）： 传 pid、trade_no 或 out_trade_no、sign。返回 code=1 时 status：0 待支付 / 1 已支付 / 2 已退款 / 3 已关闭， endtime 为支付时间戳（未支付为 0）。
注册商户后即可在「测试支付」里一键发起本站闭环演示，或直接用官网首页的演示卡片体验全流程。