Inquiry Status Disbursement

Mengecek status transaksi disbursement berdasarkan ID transaksi merchant.

Endpoint

POST /api/v1/disbursement/inquiry

Headers

Header	Nilai
token	Token autentikasi merchant
Content-Type	application/json

Request Body

Parameter	Tipe	Wajib	Keterangan
merchantTrxId	string	Ya	ID transaksi unik dari merchant

Contoh Request

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"
}

Response Sukses

{
  "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 Response

Field	Keterangan
logId	ID log untuk keperluan debugging
status	Status response (true = sukses)
message	Pesan response
data.idMerchant	ID merchant
data.merchantName	Nama merchant
data.merchantTrxId	ID transaksi merchant
data.platformTrxId	ID transaksi platform
data.accountNo	Nomor rekening tujuan
data.accountName	Nama pemilik rekening
data.amount	Jumlah transfer (dalam Rupiah)
data.fee.amount	Nominal fee disbursement yang ditagih ke merchant
data.fee.percentage	Selalu 0 — fee disbursement bersifat tetap per transaksi
data.fee.fixed	Komponen fee tetap merchant
data.totalAmount	Total yang didebit dari saldo merchant (amount + fee.amount)
data.status	Status transaksi (lihat tabel di bawah)
data.success_at	Waktu berhasil, null jika belum sukses

Status Transaksi

Status	Keterangan	Nilai fee
pending	Transaksi sedang diproses	Fee yang akan ditagih
success	Transaksi berhasil	Fee final yang ditagih
failed	Transaksi gagal	0 — dana dikembalikan penuh

Fee pada Transaksi Gagal

Contoh response di atas berstatus failed, sehingga fee.amount bernilai 0 dan totalAmount sama dengan amount. Dana yang sudah dipotong dikembalikan penuh tanpa fee. Pada transaksi success, fee.amount akan terisi sesuai fee yang ditagih (mis. 1500).