XPay API
稳定版 API · v1.0
产品级 API 文档
面向商户与第三方系统的支付、代付、OnRamp 和回调对接文档。统一签名、统一返回、统一状态定义,帮助你快速完成接入。
4业务模块
POST主请求方式
MD5签名算法
OK回调确认
接入流程
获取 appid / appsecret → 生成签名 → 创建订单 → 监听回调 → 查询状态。
获取 appid / appsecret → 生成签名 → 创建订单 → 监听回调 → 查询状态。
联调建议
先测试签名与回调,再上线正式域名,确保幂等与验签逻辑正确。
先测试签名与回调,再上线正式域名,确保幂等与验签逻辑正确。
请求与响应示例
请求示例(公共字段)
请求参数
{
"appid": "Zu78qwe1",
"merchantOrderNo": "Order202409291231",
"notifyUrl": "https://callback.example.com/order",
"attach": "user001",
"signature": "6F3B90783FABE56DBB771D03E0EAADD0"
}
通用返回
返回结果
{
"code": 0,
"message": "success",
"data": {}
}