list_unpaid_bills
Dari tagihan yang Anda simpan, mencari yang belum dibayar dan menyiapkan pesan pengingatnya.
Mengecek status terkini sejumlah tagihan sekaligus, lalu memilahnya: mana yang perlu diingatkan sekarang (lengkap dengan pesan pengingat), mana yang baru saja diingatkan, dan mana yang sudah selesai.
Server tidak menyimpan daftar tagihan. Anda mengirim catatan tracking yang Anda simpan dari create_payment_link. Alur lengkapnya ada di Pengingat Tagihan.
Input
| Field | Tipe | Wajib | Keterangan |
|---|---|---|---|
bills |
array | Ya | 1–50 catatan tagihan. Lebih dari 50: bagi ke beberapa panggilan. |
bills[].payment_id |
string (UUID) | Ya | id tagihan dari Aulaa. |
bills[].customer_name |
string | Tidak | Untuk sapaan di pesan pengingat. |
bills[].description |
string | Tidak | Untuk keperluan tagihan di pesan pengingat. |
bills[].last_reminded_at |
string (ISO 8601) | Tidak | Kapan terakhir diingatkan. Kosongkan bila belum pernah. |
remind_every_minutes |
integer | Tidak | Jarak minimal antar pengingat untuk tagihan yang sama, 1–43.200 menit (30 hari). Kosongkan = semua tagihan yang belum dibayar dianggap perlu diingatkan sekarang. |
send_within_minutes |
integer | Tidak | Berapa menit setelah pengecekan pengingat masih boleh dikirim, 1–60. Bawaan 5. |
remind_every_minutes dihitung dari last_reminded_at. Bila tagihan belum pernah diingatkan, dihitung dari waktu tagihan dibuat.
Contoh
{
"bills": [
{
"payment_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"customer_name": "Andi",
"description": "DP katering 50 porsi"
},
{ "payment_id": "00000000-0000-4000-8000-000000000000" }
],
"remind_every_minutes": 180
}
Teks untuk chatbot:
2 tagihan dicek: 1 belum dibayar (total Rp150.000), 1 perlu diingatkan sekarang, 0 belum waktunya, 0 kedaluwarsa, 0 selesai, 1 gagal dicek.
Kirim reminder_message di to_remind ke pelanggannya SEKARANG (sebelum 18 November 2026 pukul 06.44 WIB), lalu simpan tracking_after_send. Jangan simpan teksnya untuk dikirim nanti; bila terlambat, panggil get_reminder tepat sebelum mengirim.
Hapus 1 payment_id di stop_tracking dari daftar Anda.
{
"checked": 2,
"checked_at": "2026-11-17T23:39:07.964Z",
"send_before": "2026-11-17T23:44:07.964Z",
"settings": { "remind_every_minutes": 180, "send_within_minutes": 5 },
"unpaid_count": 1,
"unpaid_total": 150000,
"unpaid_total_formatted": "Rp150.000",
"to_remind": [
{
"id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"order_id": "INV-20261117-ANDI",
"status": "pending",
"status_label": "Menunggu pembayaran",
"amount": 150000,
"amount_formatted": "Rp150.000",
"payment_link": "https://payment.aulaa.co/pay/f47ac10b-58cc-4372-a567-0e02b2c3d479",
"expired_at_wib": "19 November 2026 pukul 06.39 WIB",
"customer_name": "Andi",
"reminder_message": "Halo Andi,\n\nKami ingin mengingatkan, tagihan untuk DP katering 50 porsi sebesar Rp150.000 (No. pesanan: INV-20261117-ANDI) belum kami terima.\n\nSilakan bayar lewat link berikut (bisa QRIS, Virtual Account, e-wallet, atau minimarket):\nhttps://payment.aulaa.co/pay/f47ac10b-58cc-4372-a567-0e02b2c3d479\n\nLink berlaku sampai 19 November 2026 pukul 06.39 WIB (sekitar 23 jam lagi).\n\nTerima kasih 🙏",
"send_before": "2026-11-17T23:44:07.964Z",
"tracking_after_send": {
"payment_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"order_id": "INV-20261117-ANDI",
"customer_name": "Andi",
"description": "DP katering 50 porsi",
"last_reminded_at": "2026-11-17T23:39:07.964Z"
}
}
],
"not_due_yet": [],
"next_check_at": null,
"expired": [],
"closed": [],
"errors": [
{
"payment_id": "00000000-0000-4000-8000-000000000000",
"error": "Aulaa API error (HTTP 404): payment not found\nTagihan dengan ID itu tidak ditemukan di project ini. Pakai `id` dari Aulaa, bukan order_id."
}
],
"stop_tracking": ["00000000-0000-4000-8000-000000000000"]
}
Isi to_remind di atas diringkas. Setiap item juga membawa semua field tagihan umum.
Field hasil
| Field | Isi |
|---|---|
to_remind |
Belum dibayar dan sudah waktunya diingatkan. Tiap item membawa reminder_message, send_before, dan tracking_after_send. Urut dari yang paling cepat kedaluwarsa. |
not_due_yet |
Belum dibayar tapi baru saja diingatkan. Berisi last_reminded_at, next_reminder_at, dan next_reminder_at_wib, tanpa teks pengingat. |
next_check_at |
Waktu paling awal ada tagihan di not_due_yet yang perlu diingatkan lagi. Pakai untuk menjadwalkan pengecekan berikutnya. |
unpaid_count / unpaid_total / unpaid_total_formatted |
Semua tagihan yang belum dibayar (to_remind + not_due_yet). |
expired |
Link sudah tidak bisa dibayar. Buat tagihan baru (order_id baru) bila pelanggan masih berutang. |
closed |
Sudah lunas, dibatalkan, gagal, atau dananya dikembalikan. |
errors |
Tagihan yang gagal dicek, dengan alasannya. |
stop_tracking |
payment_id yang sudah selesai, termasuk yang tidak ditemukan. Hapus dari daftar Anda. |
checked_at / send_before |
Waktu pengecekan dan batas kirim pengingat. send_before bernilai null bila to_remind kosong. |
settings |
Preferensi yang dipakai untuk pengecekan ini. |
Hal yang perlu diperhatikan
- Kirim
reminder_messagesebelumsend_before. Pengingat hanya benar pada saat dicek. Bila terlambat, panggil get_reminder tepat sebelum mengirim. - Setelah mengirim, ganti catatan tagihan dengan
tracking_after_send. Isinya sudah memuatlast_reminded_at, jadi pengecekan berikutnya menghormatiremind_every_minutes. payment_idyang sama dikirim dua kali dihitung sekali. Konteks (nama, keperluan) diambil dari yang pertama.- Satu panggilan dibatasi sekitar 30 detik. Tagihan yang belum sempat dicek masuk
errorsdengan pesan "Belum sempat dicek (batas waktu)". Tagihan itu tidak masukstop_tracking, jadi cek lagi di panggilan berikutnya. - Tagihan dicek lima sekaligus. Satu tagihan yang gagal tidak menggagalkan yang lain.
Terakhir diperbarui 17 November 2026