Bayar Tagihan

Produk pascabayar (PLN, BPJS, IndiHome/Telkom, internet, dll) butuh cek tagihan dulu untuk mengetahui nominalnya, baru dibayar. Alurnya dua langkah.

Alur

1. Cek Tagihan

key

Dapat inquiry_token

check_circle

2. Bayar

inquiry_token berlaku 10 menit dan sekali pakai. Nominal diambil ulang dari server saat order — nilai dari klien tidak dipercaya.

Langkah 1 — Cek Tagihan

POST

/v1/trx/inquiry

Parameter	Type	Description
`item_id` Required	integer	ID item/variant produk tagihan.
`target` Required	string	Nomor / ID pelanggan (mis. ID pelanggan IndiHome, nomor BPJS).

Langkah 2 — Bayar

POST

/v1/trx

Gunakan endpoint order seperti biasa, sertakan inquiry_token pada item. note diisi nomor pelanggan (target), quantity selalu 1.

Field	Type	Description
`carts.*.inquiry_token` Required	string	Token dari respons Langkah 1. Wajib untuk produk tagihan.
`carts.*.note` Required	string	Nomor / ID pelanggan (sama dengan `target` saat inquiry).

Catatan Kebijakan

paid Harga yang ditagihkan = nominal hasil inquiry (diambil ulang server), bukan nilai dari klien.
sell Voucher secara default tidak berlaku untuk produk tagihan.
refresh Jika provider menolak (mis. tagihan keburu dibayar), transaksi gagal & saldo otomatis di-refund.

Error Responses

422 POSTPAID_INQUIRY_EXPIRED

inquiry_token tidak valid / kedaluwarsa. Lakukan cek tagihan ulang.

422 POSTPAID_REQUIRES_TARGET_AND_INQUIRY_TOKEN

target dan inquiry_token wajib diisi untuk produk tagihan.

422 (inquiry) ID pelanggan tidak terdaftar / tagihan sudah dibayar

Pesan ramah dari provider dikembalikan di field message.

1. Cek Tagihan

curl --request POST \
  --url https://sekalipay.com/api/v1/trx/inquiry \
  --header 'X-APIKEY: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "item_id": 1234,
    "target": "121314141414"
  }'

Respons Inquiry

200 OK

{
  "message": "OK",
  "data": {
    "inquiry_token": "9f1c2e3a-...-c0de",
    "nama": "John Doe",
    "periode": "JUN 26",
    "bill_amount": 316350,
    "admin": 1950,
    "total": 320300,
    "expired_at": "2026-06-13T21:40:00+07:00"
  }
}

2. Bayar (pakai token)

curl --request POST \
  --url https://sekalipay.com/api/v1/trx \
  --header 'X-APIKEY: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "ref_id": "TAG-2026-001",
    "carts": [
      {
        "item_id": 1234,
        "quantity": 1,
        "note": "121314141414",
        "inquiry_token": "9f1c2e3a-...-c0de"
      }
    ]
  }'