Inquiry Status Disbursement

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

Endpoint

POST /api/v1/disbursement/inquiry

Headers

Header	值
token	商户鉴权 token
Content-Type	application/json

Request Body

Parameter	Type	Required	Description
merchantTrxId	string	Yes	商户侧唯一交易 ID

示例请求

curl --location 'https://api-pay.pingaja.web.id/api/v1/disbursement/inquiry' \
--header 'token: <merchant-token>' \
--header 'Content-Type: application/json' \
--data '{
    "merchantTrxId": "20260331111111118"
}'

{
  "merchantTrxId": "20260331111111118"
}

成功响应

{
  "logId": "wzaOFV60mvr9VSg1rYh8",
  "status": true,
  "message": "Query success",
  "data": {
    "idMerchant": 2,
    "merchantName": "Mie Ayam",
    "merchantTrxId": "20260331111111118",
    "platformTrxId": "20260402225852925871811",
    "accountNo": "2389472834",
    "accountName": "John Doe",
    "amount": 10000,
    "fee": {
      "amount": 0,
      "percentage": 0,
      "fixed": 0
    },
    "totalAmount": 10000,
    "status": "failed",
    "success_at": null
  }
}

响应字段

Field	Description
logId	用于排查问题的日志 ID
status	响应状态（true 表示成功）
message	响应消息
data.idMerchant	商户 ID
data.merchantName	商户名称
data.merchantTrxId	商户交易 ID
data.platformTrxId	平台交易 ID
data.accountNo	收款账号
data.accountName	账户姓名
data.amount	转账金额（印尼盾）
data.fee.amount	向商户收取的代付手续费
data.fee.percentage	恒为 0 —— 代付手续费按笔固定收取
data.fee.fixed	商户固定手续费部分
data.totalAmount	从商户余额扣除的总额（amount + fee.amount）
data.status	交易状态（见下表）
data.success_at	成功时间，未成功时为 null

交易状态

Status	说明	fee 取值
pending	交易处理中	预计收取的手续费
success	交易成功	实际收取的最终手续费
failed	交易失败	0 —— 全额退回

交易失败时的手续费

上面的示例响应状态为 failed，因此 fee.amount 为 0，totalAmount 与 amount 相同。已扣除的资金将全额退回且不收取手续费。交易 success 时，fee.amount 为实际收取的手续费（例如 1500）。