Menu dokumentasi

Daftar Tools

Enam tool Aulaa MCP Server, kapan dipakai, dan bentuk hasilnya.

Aulaa MCP Server punya enam tool. Chatbot memilih sendiri tool yang tepat dari permintaan Anda, jadi Anda tidak perlu menyebut namanya.

Tool Gunanya Mengubah data? Endpoint Aulaa
create_payment_link Membuat tagihan + pesan siap kirim Ya (membuat tagihan) POST /v1/payments
get_payment_status Mengecek status satu tagihan Tidak GET /v1/payments/{id}
list_unpaid_bills Mencari yang belum bayar + pesan pengingat Tidak GET /v1/payments/{id} per tagihan
get_reminder Cek ulang satu tagihan tepat sebelum diingatkan Tidak GET /v1/payments/{id}
cancel_payment Membatalkan tagihan yang belum dibayar Ya (membatalkan) POST /v1/payments/{id}/cancel
list_payment_methods Metode pembayaran aktif + batas nominal Tidak GET /v1/payments/methods

Tidak ada tool untuk melihat saldo, menarik dana, mengubah pengaturan project, atau melihat daftar transaksi. Chatbot hanya mengenal tagihan yang payment_id-nya ia simpan sendiri.

Bentuk hasil

Setiap tool yang berhasil mengembalikan dua hal sekaligus:

  1. Ringkasan dalam bahasa Indonesia untuk dibaca model AI, misalnya Link penagihan siap: https://payment.aulaa.co/pay/... (Rp150.000).
  2. Data JSON (structuredContent) untuk diproses kode Anda. Data yang sama juga ditempel di akhir teks, untuk klien yang tidak membaca structuredContent.

Bila gagal, hasilnya bertanda isError: true dan teksnya berisi penyebab serta saran perbaikan. Lihat Keamanan, Batasan & Error.

Field tagihan yang sering muncul

Tool yang mengembalikan tagihan memakai field yang sama:

Field Tipe Keterangan
id string (UUID) ID tagihan di Aulaa. Inilah payment_id untuk tool lain.
order_id string ID pesanan dari Anda.
status string pending, paid, expired, cancelled, failed, atau refunded.
status_label string Status dalam bahasa Indonesia, mis. Menunggu pembayaran, Lunas.
amount integer Nominal tagihan dalam Rupiah.
amount_formatted string Nominal siap baca, mis. Rp150.000.
payment_method string | null Metode yang dikunci saat dibuat, atau null bila pelanggan bebas memilih.
payment_link string Link pembayaran untuk pelanggan.
is_test boolean true untuk tagihan sandbox (tanpa uang sungguhan).
expired_at / expired_at_wib string | null Batas bayar (ISO 8601 UTC / teks WIB).
paid_at / paid_at_wib string | null Waktu lunas (ISO 8601 UTC / teks WIB).

Tagihan pending yang sudah melewati expired_at langsung dilaporkan sebagai expired, walau Aulaa belum sempat memperbarui statusnya. Dengan begitu chatbot tidak mengirim link yang sudah tidak bisa dibayar.

Status tagihan

status status_label Masih bisa dibayar?
pending Menunggu pembayaran Ya
paid Lunas Tidak, sudah lunas
expired Kedaluwarsa Tidak. Buat tagihan baru dengan order_id baru.
cancelled Dibatalkan Tidak
failed Gagal Tidak
refunded Dana dikembalikan Tidak

Terakhir diperbarui 17 November 2026