XPay · API Documentation
Merchant Integration Handbook
XPay API 接口文档
用于商户接入支付、代付与 OnRamp 的正式文档中心。这里汇总签名、公共参数、错误码、状态说明与各接口示例,帮助开发者快速完成对接并稳定上线。
API Handbook以清晰章节与标准示例组织内容,帮助商户、开发者与测试同学在最短时间内完成对接。
6导航分组
15文档页面
1统一签名规范
0模板依赖冲突
文档导读
这是一套更像 GitBook 书封面的接口文档首页:信息更聚焦,视觉更简洁,结构更像一本书的目录入口。
接入流程
获取 appId / appSecret → 生成签名 → 创建订单 → 监听回调 → 查询状态。
获取 appId / appSecret → 生成签名 → 创建订单 → 监听回调 → 查询状态。
联调建议
先测试签名与回调,再上线正式域名,确保幂等与验签逻辑正确。
先测试签名与回调,再上线正式域名,确保幂等与验签逻辑正确。
快速导航
| 模块 | 说明 |
|---|---|
| 签名算法 | 请求验签规则与示例 |
| 公共参数 | 所有接口通用字段 |
| 错误码总表 | 统一错误码说明 |
| 字段表统一版 | 通用字段汇总 |
| 返回状态说明 | 状态值与适用场景 |
请求与响应示例
请求示例(公共字段)
{
"appId": "Zu78qwe1",
"merchantOrderNo": "Order202409291231",
"notifyUrl": "https://callback.example.com/order",
"attach": "user001",
"signature": "6F3B90783FABE56DBB771D03E0EAADD0"
}通用返回
{
"code": 0,
"message": "success",
"data": {}
}