Inquiry QRIS

根据商户交易 ID 查询 QRIS 交易状态。

Endpoint

POST /api/v1/payin/qris/inquiry

Request Body

Parameter	Type	Required	Description
merchantTrxId	string	Yes	需要查询的商户交易 ID

示例请求

{
  "merchantTrxId": "2026022016571814795775589"
}

成功响应

{
  "logId": "OIZ1AHKte0s27yAMhu4o",
  "status": true,
  "message": "Query success",
  "data": {
    "idMerchant": 2,
    "merchantName": "Mie Ayam",
    "merchantTrxId": "2026011422090788287851188",
    "platformTrxId": "2026011415091972123",
    "amount": 11000,
    "fee": {
      "amount": 77,
      "percentage": 0.7,
      "fixed": 0
    },
    "netAmount": 10923,
    "status": "success",
    "success_at": "2026-01-14 15:10:11",
    "additionalInfo": {
      "rrn": "837952845864",
      "nmid": "ID2024000000317"
    }
  }
}

响应字段

Field	Description
idMerchant	平台内商户 ID
merchantName	商户名称
merchantTrxId	商户交易 ID
platformTrxId	平台交易 ID
amount	交易金额
fee.amount	本笔交易向商户收取的手续费
fee.percentage	商户费率百分比（0.7 表示 0.7%）
fee.fixed	商户固定手续费部分
netAmount	商户实际到账金额（amount - fee.amount）
status	交易状态（success、pending、failed 等）
success_at	交易成功时间
additionalInfo.rrn	Reference Retrieval Number
additionalInfo.nmid	National Merchant ID