Menu dokumentasi

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_message sebelum send_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 memuat last_reminded_at, jadi pengecekan berikutnya menghormati remind_every_minutes.
  • payment_id yang 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 errors dengan pesan "Belum sempat dicek (batas waktu)". Tagihan itu tidak masuk stop_tracking, jadi cek lagi di panggilan berikutnya.
  • Tagihan dicek lima sekaligus. Satu tagihan yang gagal tidak menggagalkan yang lain.

Terakhir diperbarui 17 November 2026