Skip to main content
根据商户交易号查询支付订单的当前状态和详细信息。

​
接口信息

项目说明
请求方式GET
路径/api/merchant/order/payment/query/{transactionId}
Content-Type—（GET 请求无 Body）
鉴权方式RSA 签名（签名原文中 Body 部分为空行）

​
路径参数

参数类型必填说明
transactionIdString是商户交易号（创建支付时传入的 merchant_transaction_id）

​
响应参数

{
  "code": 200,
  "msg": "success",
  "data": {
    "platform_transaction_id": "1000126011700000100001",
    "merchant_transaction_id": "ORDER-20260101-001",
    "payment_currency_code": "USD",
    "payment_amount": 100.00,
    "payment_status": 2,
    "payment_success_time": "2026-01-01T12:30:00",
    "settlement_currency_code": "USD",
    "settlement_amount": 97.00
  }
}

​
字段说明

字段类型说明
platform_transaction_idString平台订单号
merchant_transaction_idString商户交易号
payment_currency_codeString支付币种
payment_amountBigDecimal支付金额
payment_statusInteger订单状态（见下方状态枚举）
payment_success_timeDateTime支付成功时间（ISO 8601）
settlement_currency_codeString结算币种（可能与支付币种不同）
settlement_amountBigDecimal结算金额（扣除手续费后）

​
支付状态枚举

状态码状态说明
0初始化订单已创建，等待支付
1支付中用户正在进行支付
2支付成功支付已完成
3支付失败支付处理失败
4部分退款已退款部分金额
5已退款订单金额全部退还
6已关闭超时未支付关闭
7争议中发生 Chargeback

​
请求示例

curl -X GET "https://openapi.paymatrixpay.com/api/merchant/order/payment/query/ORDER-20260101-001" \
  -H "X-Merchant-Id: 10001" \
  -H "X-Timestamp: 1737004800000" \
  -H "X-Nonce: a3f7b2c1d4e5" \
  -H "X-Signature: <RSA_SIGNATURE>"

​
使用场景

  • 后台对账：定时拉取订单状态与本地系统核对
  • 状态排查：Webhook 未收到或延迟时，手动查询确认
  • 页面轮询：收银台跳转后，轮询确认支付结果（仅作为 Webhook 的补充）
建议以 Webhook 通知 作为状态变更的主要驱动，支付查询接口仅作为辅助验证和异常排查使用，避免高频轮询。

​
相关页面