提现请求
请求
API URL: /merchant/v2/{GUID}/withdraw
Note
{GUID} 由商户后台取得(API 对接 -> GUID)
✅ 必填 ⭕ 可选 ❌ 不适用
标头 | 内容 | 描述 |
---|---|---|
Content-Type | text/plain | |
X-Transaction-Signature | {transaction_signature} | 请参阅 交易签名 |
参数 | 类型 | 必填 | 签名 | 描述 |
---|---|---|---|---|
user_id | 字符串 | ✅ | ✅ | 商户标识码。 |
order_id | 字符串 | ✅ | ✅ | 商户系统的提现订单ID。订单ID应保持唯一。 |
amount | 字符串 | ✅ | ✅ | 交易金额(支持最多6位小数)。 |
currency | 字符串 | ✅ | ✅ | 请参考 支持通道 。 |
channel | 字符串 | ✅ | ✅ | 请参考 支持通道 。 |
timestamp | 整数 | ✅ | ✅ | 请求时间戳(10位数字),允许时间差为5秒,超过则失败。 |
details | 物件 | ✅ | ❌ | Details 物件 依通道而定。 |
callback_url | URL | ⭕ | ❌ | 服务将在交易完成时向此URL发送回调请求。 |
remark | 字符串 | ⭕ | ❌ | 备注。 |
sign | 字符串 | ✅ | ❌ | 签名字符串。请参阅 数据签名与验证 |
Details 物件
参数 | 类型 | 描述 |
---|
响应
参数 | 类型 | 必填 | 签名 | 描述 |
---|---|---|---|---|
user_id | 字符串 | ✅ | ✅ | 商户标识码 |
order_id | 字符串 | ✅ | ✅ | 商户系统的提现订单ID。订单ID应保持唯一 |
transaction_id | 字符串 | ✅ | ✅ | PTS 提现交易ID |
channel | 字符串 | ✅ | ✅ | 支持的通道,请参考 支持通道 |
submit_currency | 字符串 | ✅ | ✅ | 提交的货币 |
submit_amount | 浮点数 | ✅ | ✅ | 提交的金额(支持最多6位小数) |
accept_currency | 字符串 | ✅ | ✅ | 实际支付的货币 |
accept_amount | 浮点数 | ✅ | ✅ | 支付的货币金额(支持最多6位小数) |
exchange_rate | 浮点数 | ✅ | ✅ | 汇率 |
sign | 字符串 | ✅ | ❌ | 签名字符串。请参阅 数据签名与验证 |
响应示例