接入说明
通过本站接口可以发起收款、接收支付结果、查询订单和申请退款。接入需要商户号和密钥，按下面的顺序准备即可。
接口可兼容 epay 的下单、页面跳转与退款请求；epay 的查单等其它接口不兼容，请按本文档调用。
准备工作
登录商户中心，打开「账户中心 → API信息」，接入要用的信息都在这里：
| 项目 | 用途 |
|---|---|
| 接口地址 | https://z.weixiao.cc/，各接口的地址都在它后面拼路径 |
| 商户号 | 请求参数 pid 的值 |
| MD5密钥 | MD5 签名用的密钥 |
| 商户私钥 | RSA 签名用的私钥 |
| 商户公钥 | 与商户私钥是一对 |
| 平台公钥 | 验 RSA 签名的支付结果通知 |
注意
密钥只保存在你的服务器上，不要写进网页或 APP。在「API信息」重置 MD5密钥、重新生成 RSA 密钥对之后，旧的立即失效，请同步更新服务器上的配置。
接口地址
| 接口 | 地址 | 方式 |
|---|---|---|
| 页面跳转支付 | https://z.weixiao.cc/submit | GET、POST |
| API 接口支付 | https://z.weixiao.cc/api | POST |
| 查询订单 | https://z.weixiao.cc/query | POST |
| 批量查询 | https://z.weixiao.cc/orders | POST |
| 申请退款 | https://z.weixiao.cc/refund | POST |
| 退款查询 | https://z.weixiao.cc/refundquery | POST |
| 关闭订单 | https://z.weixiao.cc/close | POST |
| 商户信息 | https://z.weixiao.cc/merchant | POST |
| 结算记录 | https://z.weixiao.cc/settle | POST |
请求规则
| 项目 | 规则 |
|---|---|
| 提交方式 | POST 表单；页面跳转支付也可 GET |
| 字符编码 | UTF-8 |
| 返回格式 | JSON（页面跳转支付除外） |
| 签名 | MD5 或 RSA，见「V1（MD5签名）」「V2（RSA签名）」 |
| 金额 | 单位为元，最多两位小数，如 1.00 |
| 时间 | YYYY-MM-DD HH:MM:SS |
- 提交方式：POST 表单（
application/x-www-form-urlencoded）；页面跳转支付也可用 GET 查询串 - 时间：
YYYY-MM-DD HH:MM:SS，如2026-09-27 12:00:35
注意
参数要么全部放在 POST 表单里，要么全部放在 URL 查询串里：POST 表单不为空时，查询串里的参数一律不读。不支持 JSON 请求体，也不支持 multipart/form-data。
商户号写法
商户号以「API信息」里显示的为准。商户号带字母前缀（如 zp1001）时，pid 传完整商户号或只传数字部分（1001）都可以，签名按你实际传的值计算。接口返回和支付结果通知里的 pid 都是数字部分。
接入流程
- 在「API信息」取得商户号和密钥。
- 下单：网站前台用「页面跳转支付」，服务器后台用「API 接口支付」。
- 付款成功后，平台向下单时传的
notify_url发送「支付结果通知」，你验签、处理订单后返回success。 - 以支付结果通知或「查询订单」的结果更新订单状态；
return_url只负责把付款人带回你的页面。 - 需要时调用「申请退款」「关闭订单」。
返回码
| code | 含义 |
|---|---|
1 | 成功 |
-1 | 请求没有成功，原因见 msg |
-2 | 订单已生成，但支付通道下单失败，原因见 msg |
申请退款返回「退款处理中」时 code 也是 -1，但退款并没有失败，见「申请退款」。全部返回信息见「错误码」。