提现请求

请求

API URL: /merchant/v2/{GUID}/withdraw

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	⭕	❌	Details 物件 依通道而定
callback_url	URL	⭕	❌	用于接收 PTS 交易完成后的回调请求的 URL
remark	字符串	⭕	❌	备注
sign	字符串	✅	❌	签名字符串。请参阅 数据签名与验证

Details 物件

MAYAGCASHQRPHChannel

参数	类型	描述
channel_subject	字符串	通道对象。请参阅 支持通道。
account_number	字符串	收款人帐号。（数字 10~20 码）。
email	字符串	有效的電子郵件格式。
phone	字符串	1. 电话号码以“09”开头，共11位数字，例如：09123456789。 2. 电话号码以“9”开头，共10位数字，例如：9123456789。
name	字符串	收款人姓名。 1. 限制为 30 字符，不可包含特殊字符，例如：「/*!@#...」，超过将截断处理。 2. 格式为：firstname middlename (可省略) lastname。若缺少 lastname，系统将自动填入「NA」。
address	字符串	收款人地址。

响应

参数	类型	必填	签名	描述
user_id	字符串	✅	✅	商户标识码
order_id	字符串	✅	✅	商户系统的提现订单ID（应保持唯一性）
transaction_id	字符串	✅	✅	FTIPH 交易ID
channel	字符串	✅	✅	请参考 支持通道
submit_currency	字符串	✅	✅	提交的货币
submit_amount	浮点数	✅	✅	提交的金额（支持最多6位小数）
accept_currency	字符串	✅	✅	实际支付的货币
accept_amount	浮点数	✅	✅	支付的金额（支持最多6位小数）
exchange_rate	浮点数	✅	✅	汇率
sign	字符串	✅	❌	签名字符串。请参阅 数据签名与验证

响应示例

{
  "code": "1000",
  "message": "Accepted",
  "data": {
    "user_id": "28",
    "order_id": "202407311241124",
    "transaction_id": "W282024073113412453",
    "channel": "MAYA",
    "submit_currency": "PHP",
    "submit_amount": 20000,
    "accept_currency": "PHP",
    "accept_amount": 20000,
    "exchange_rate": 1,
    "sign": "daseqw3t6uhghfsdeD8t2RyNzL..."
  }
}