Cek Status Transaksi

Mengecek status terkini dari transaksi PPOB berdasarkan order_req_id.

URL: POST /api/v1/merchant/ppob/check

Kapan Menggunakan

Setelah menerima status: "PENDING" dari endpoint transaksi.
Untuk memverifikasi hasil transaksi yang gagal karena timeout jaringan.
Jangan kirim ulang transaksi sebelum mengecek status terlebih dahulu.

Request

Headers

Header	Wajib	Keterangan
`X-API-Key`	Ya	API Key merchant
`Content-Type`	Ya	`application/json`

Query Parameter

Parameter	Tipe	Keterangan
`direct`	Boolean	Jika `true`, juga query live status dari biller (action status)

Body

Field	Tipe	Wajib	Keterangan
`order_req_id`	String	Ya	`req_id` dari transaksi yang ingin dicek

Contoh Request

{
  "order_req_id": "TXN-20240501-001"
}

curl -X POST "https://api-sandbox.alfakios.com/api/v1/merchant/ppob/check" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: apk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -d '{"order_req_id": "TXN-20240501-001"}'

# Dengan live check ke biller
curl -X POST "https://api-sandbox.alfakios.com/api/v1/merchant/ppob/check?direct=true" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: apk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -d '{"order_req_id": "TXN-20240501-001"}'

Response

Spesifikasi

Field	Tipe	Keterangan
`req_id`	String	`order_req_id` yang dikirim
`ref_id`	String	ID referensi internal sistem
`product_id`	String	Kode produk
`cust_id`	String	ID customer / nomor tujuan
`status`	String	`SUCCESS`, `FAILED`, atau `PENDING`
`rc`	String	Kode respon
`description`	String	Keterangan RC
`message`	String	Pesan detail
`unit_price`	String	Harga produk
`balance_used`	String	Saldo yang terpotong
`balance`	String	Saldo merchant setelah transaksi
`serial_no`	String	Nomor seri / token dari biller
`data`	Object	Data tambahan dari biller
`biller`	Object	(opsional) Payload live biller jika `direct=true`

Contoh Response — Transaksi Ditemukan

{
  "success": true,
  "message": "Transaction status checked successfully",
  "rc": "000",
  "data": {
    "req_id": "TXN-20240501-001",
    "ref_id": "1777946295495371000",
    "product_id": "XL5",
    "cust_id": "08123456789",
    "status": "SUCCESS",
    "rc": "000",
    "description": "Transaksi Sukses",
    "message": "PULSA XL 5000 KE 08123456789 SUKSES",
    "unit_price": "5500",
    "balance_used": "5500",
    "balance": "494500",
    "serial_no": "REF123456789",
    "data": {}
  }
}

Contoh Response — Transaksi Tidak Ditemukan

{
  "success": false,
  "message": "Transaction not found",
  "rc": "002"
}

HTTP Status: 400 Bad Request

Catatan Penting

Endpoint ini hanya bisa mengecek transaksi yang dibuat oleh merchant yang sama (API Key yang sama).
Parameter direct=true menyebabkan query langsung ke biller — gunakan dengan hati-hati karena dapat memperlambat response.
Jika order_req_id tidak ditemukan, pastikan ejaan sudah benar dan transaksi memang pernah dibuat dengan merchant ini.

Keyboard shortcuts

Relay Merchant API