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:
- Ringkasan dalam bahasa Indonesia untuk dibaca model AI, misalnya
Link penagihan siap: https://payment.aulaa.co/pay/... (Rp150.000). - Data JSON (
structuredContent) untuk diproses kode Anda. Data yang sama juga ditempel di akhir teks, untuk klien yang tidak membacastructuredContent.
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
pendingyang sudah melewatiexpired_atlangsung dilaporkan sebagaiexpired, 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