付款请求
请求
API URL: /merchant/v2/{GUID}/payment
Note
{GUID} 由商户后台取得(API 对接 -> GUID)
✅ 必填 ⭕ 可选 ❌ 不适用
标头 | 内容 | 说明 |
---|---|---|
Content-Type | text/plain | |
X-Transaction-Signature | {transaction_signature} | 请参阅 交易签名 |
参数 | 类型 | 必填 | 签名 | 描述 |
---|---|---|---|---|
user_id | 字符串 | ✅ | ✅ | 商户标识码 |
order_id | 字符串 | ✅ | ✅ | 商户系统的支付订单ID(应保持唯一性)。 |
amount | 字符串 | ✅ | ✅ | 交易金额(支持最多6位小数。 |
currency | 字符串 | ✅ | ✅ | 请参阅 支持通道。 |
channel | 字符串 | ✅ | ✅ | 请参考 支持通道 |
timestamp | 整数 | ✅ | ✅ | 请求时间戳(10位数字),允许时间差为5秒,超过则失败。 |
details | 物件 | ⭕ | ❌ | Details 物件 依通道而定。 |
callback_url | URL | ⭕ | ❌ | 用于接收 PTS 交易完成后的回调请求的 URL。 |
redirect_url | URL | ⭕ | ❌ | 当支付过程完成时,用户将被重定向到此 URL。 |
error_url | URL | ⭕ | ❌ | 当支付过程错误或失败时,用户将被重定向到此 URL。 |
remark | 字符串 | ⭕ | ❌ | 备注。 |
sign | 字符串 | ✅ | ❌ | 签名字符串。请参阅 数据签名与验证 |
响应
参数 | 类型 | 必填 | 签名 | 描述 |
---|---|---|---|---|
user_id | 字符串 | ✅ | ✅ | 商户标识码 |
order_id | 字符串 | ✅ | ✅ | 商户系统的支付订单ID(应保持唯一性) |
transaction_id | 字符串 | ✅ | ✅ | PTS 交易ID |
channel | 字符串 | ✅ | ✅ | 请参阅 支持通道 |
submit_currency | 字符串 | ✅ | ✅ | 提交的货币 |
submit_amount | 浮点数 | ✅ | ✅ | 提交的金额(支持最多6位小数) |
accept_currency | 字符串 | ✅ | ✅ | 实际支付的货币 |
accept_amount | 浮点数 | ✅ | ✅ | 支付的金额(支持最多6位小数) |
exchange_rate | 浮点数 | ✅ | ✅ | 汇率 |
pay_url | URL | ✅ | ✅ | 用于支付金额的网页 |
wallet_address | 字符串 | ⭕ | ❌ | 专用于加密货币,如有需要,请通知客服人员 |
expired_at | 整数 | ⭕ | ❌ | 专用于加密货币,如有需要,请通知客服人员 |
qr_code | 字符串 | ⭕ | ❌ | 付款用QR码(限通道QRPH、INSTAPAY) |
sign | 字符串 | ✅ | ❌ | 签名字符串。请参阅 数据签名与验证 |
响应示例