付款查询

请求

API URL: /merchant/v2/{GUID}/payment/query

Note

{GUID} 由商户后台取得（API 对接 -> GUID）

✅ 必填 ⭕ 可選 ❌ 不適用

标头	内容	描述
Content-Type	text/plain
X-Transaction-Signature	{transaction_signature}	请参阅 交易签名

参数	类型	必填	签名	描述
user_id	字符串	✅	✅	商户标识码
order_id	字符串	✅	✅	您的订单ID。订单ID应保持唯一。
timestamp	整数	✅	✅	请求时间戳（10位数字），允许时间差为5秒，超过则失败。
sign	字符串	✅	❌	签名字符串。请参阅 数据签名与验证

响应

参数	类型	必填	签名	描述
user_id	字符串	✅	✅	商户标识码
order_id	字符串	✅	✅	商户系统的支付订单 ID。订单 ID 应保持唯一
transaction_id	字符串	✅	✅	PTS 交易ID
channel	字符串	✅	✅	请参考 支持通道
submit_currency	字符串	✅	✅	提交的货币
submit_amount	浮点数	✅	✅	提交的金额（支持最多6位小数）
accept_currency	字符串	✅	✅	实际支付的货币
accept_amount	浮点数	✅	✅	支付的金额（支持最多6位小数）
exchange_rate	浮点数	✅	✅	汇率
status	字符串	✅	✅	0000 = 等待 1000 = 处理中 2000 = 成功 3000 = 失败 4000 = 订单错误
timestamp	整数	✅	✅	交易的最后更新时间戳（10位数字）
submit_promo	浮点数	⭕	❌	提交金额促销（支持最多6位小数）
accept_promo	浮点数	⭕	❌	支付的货币的促销金额（支持最多6位小数）
payment_address	字符串	⭕	❌	专用于加密货币，如有需要，请通知客服人员
receiving_address	字符串	⭕	❌	专用于加密货币，如有需要，请通知客服人员
error_message	字符串	⭕	❌	错误信息
reference_number	字符串	⭕	❌	GCASH 交易编号 或 QRPH 发票编号（reference number）
sign	字符串	✅	❌	签名字符串。请参阅 数据签名与验证

响应示例