Menu dokumentasi

get_reminder

Cek ulang satu tagihan tepat sebelum pengingat dikirim; teks hanya diberikan bila masih belum dibayar.

Mengecek ulang satu tagihan ke Aulaa tepat sebelum pengingat dikirim. Teks pengingat hanya diberikan bila tagihan masih belum dibayar dan sudah waktunya diingatkan.

Pakai tool ini bila:

  • pengingat dikirim satu per satu,
  • send_before dari list_unpaid_bills sudah lewat, atau
  • pengecekan terakhir bukan dari saat ini.

Dengan cara ini jeda antara cek dan kirim tinggal hitungan detik, sehingga pelanggan yang baru saja membayar tidak menerima pengingat.

Input

Field Tipe Wajib Keterangan
payment_id string (UUID) Ya id tagihan dari Aulaa.
customer_name string Tidak Untuk sapaan di pesan pengingat.
description string Tidak Untuk keperluan tagihan di pesan pengingat.
last_reminded_at string (ISO 8601) Tidak Kapan terakhir diingatkan.
remind_every_minutes integer Tidak Jarak minimal antar pengingat, 1–43.200 menit.
send_within_minutes integer Tidak Batas kirim setelah dicek, 1–60 menit. Bawaan 5.

Hasil

Selalu ada field send (boolean) dan semua field tagihan umum.

Keadaan send Field tambahan stop_tracking
Belum dibayar dan sudah waktunya true reminder_message, send_before, tracking_after_send –
Belum dibayar, tapi belum waktunya menurut remind_every_minutes false reason, next_reminder_at false
Sudah lunas false reason, mis. sudah dibayar (18 November 2026 pukul 10.12 WIB) true
Kedaluwarsa false reason true
Dibatalkan, gagal, atau dananya dikembalikan false reason true

Contoh: belum waktunya

{
  "payment_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "customer_name": "Andi",
  "last_reminded_at": "2026-11-17T23:39:07.964Z",
  "remind_every_minutes": 180
}
JANGAN kirim pengingat: tagihan order INV-20261117-ANDI belum waktunya diingatkan lagi (paling cepat 18 November 2026 pukul 09.39 WIB).
{
  "send": false,
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "order_id": "INV-20261117-ANDI",
  "status": "pending",
  "status_label": "Menunggu pembayaran",
  "amount_formatted": "Rp150.000",
  "reason": "belum waktunya diingatkan lagi (paling cepat 18 November 2026 pukul 09.39 WIB)",
  "stop_tracking": false,
  "next_reminder_at": "2026-11-18T02:39:07.964Z"
}

Contoh: masih belum dibayar

Tagihan order INV-20261117-ANDI (Rp150.000) masih belum dibayar. Kirim reminder_message sekarang, lalu simpan tracking_after_send.

Hasilnya membawa send: true, reminder_message, send_before, dan tracking_after_send dengan bentuk yang sama seperti item to_remind di list_unpaid_bills.

Contoh: sudah dibatalkan

JANGAN kirim pengingat: tagihan order INV-20261117-ANDI berstatus Dibatalkan.
{ "send": false, "status": "cancelled", "reason": "berstatus Dibatalkan", "stop_tracking": true, "...": "..." }

Bila stop_tracking bernilai true, hapus tagihan itu dari daftar Anda.

Terakhir diperbarui 17 November 2026