create_payment_link
Membuat tagihan dan pesan tagihan yang siap dikirim ke pelanggan.
Membuat tagihan baru di Aulaa, lalu mengembalikan link pembayaran, pesan tagihan yang siap dikirim, dan catatan tracking untuk disimpan.
Input
| Field | Tipe | Wajib | Keterangan |
|---|---|---|---|
order_id |
string | Ya | ID unik tagihan, 1–255 karakter, mis. INV-20261117-ANDI-01. Pakai nilai yang sama bila mengulang permintaan untuk tagihan yang sama. |
amount |
integer | Ya | Nominal dalam Rupiah tanpa desimal, Rp1.000–Rp500.000.000. Contoh: 150000 untuk Rp150.000. |
payment_method |
string | Tidak | Kunci satu metode, mis. qris atau bca_va (lihat list_payment_methods). Kosongkan supaya pelanggan bebas memilih (disarankan). |
redirect_url |
string (URL) | Tidak | Alamat http(s) tujuan pelanggan setelah membayar. |
customer_name |
string | Tidak | Nama pelanggan, maks. 100 karakter. Dipakai untuk sapaan di pesan. |
description |
string | Tidak | Keperluan tagihan, maks. 200 karakter, mis. DP katering 50 porsi. Dipakai di pesan. |
customer_name dan description hanya dipakai untuk menyusun pesan dan catatan tracking. Keduanya tidak dikirim ke Aulaa.
Batas nominal yang sebenarnya juga mengikuti metode pembayaran yang aktif di project Anda.
Contoh
Permintaan "Tagih Andi Rp150.000 untuk DP katering 50 porsi" membuat chatbot memanggil:
{
"order_id": "INV-20261117-ANDI",
"amount": 150000,
"customer_name": "Andi",
"description": "DP katering 50 porsi"
}
Hasilnya:
{
"id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"order_id": "INV-20261117-ANDI",
"status": "pending",
"status_label": "Menunggu pembayaran",
"amount": 150000,
"amount_formatted": "Rp150.000",
"payment_method": null,
"payment_link": "https://payment.aulaa.co/pay/f47ac10b-58cc-4372-a567-0e02b2c3d479",
"is_test": false,
"expired_at": "2026-11-18T23:39:07.907Z",
"expired_at_wib": "19 November 2026 pukul 06.39 WIB",
"paid_at": null,
"paid_at_wib": null,
"already_existed": false,
"customer_message": "Halo Andi,\n\nBerikut tagihan untuk DP katering 50 porsi sebesar Rp150.000.\nNo. pesanan: INV-20261117-ANDI\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.\n\nTerima kasih 🙏",
"tracking": {
"payment_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"order_id": "INV-20261117-ANDI",
"customer_name": "Andi",
"description": "DP katering 50 porsi"
},
"notes": []
}
Field hasil
Selain field tagihan umum:
| Field | Keterangan |
|---|---|
customer_message |
Pesan tagihan siap kirim: sapaan, keperluan, nominal, no. pesanan, link, dan batas waktu dalam WIB. null bila tagihan sudah tidak bisa dibayar. |
tracking |
Catatan yang wajib disimpan chatbot atau sistem Anda untuk cek status dan pengingat. null bila tagihan sudah tidak bisa dibayar. |
already_existed |
true bila order_id sudah pernah dipakai dan yang dikembalikan adalah tagihan lama. |
notes |
Peringatan untuk chatbot, mis. nominal berbeda atau tagihan sandbox. |
Bila payment_method dikunci, kalimat pembayaran di pesan tidak menyebut pilihan metode lain.
order_id yang sama tidak membuat tagihan ganda
order_id unik per project. Bila chatbot mengulang order_id yang sama, misalnya karena koneksi putus lalu mencoba lagi, server mengambil tagihan yang sudah ada dan tidak membuat tagihan kedua. Teksnya memberi tahu chatbot:
order_id "INV-20261117-ANDI" sudah pernah dipakai; ini tagihan yang sudah ada (tidak dibuat baru).
PERHATIAN: nominal tagihan yang ada Rp150.000, berbeda dari yang diminta Rp175.000. Pakai order_id baru bila memang tagihan berbeda.
Bila tagihan lama itu sudah lunas, kedaluwarsa, atau dibatalkan, customer_message dan tracking bernilai null, dan chatbot diminta tidak mengirim link itu. Buat tagihan baru dengan order_id lain.
Bentuk
order_idyang baik: awalan toko + tanggal + nama + nomor urut, mis.KTR-20261117-ANDI-01. Untuk pelunasan atau tagihan kedua ke pelanggan yang sama, naikkan nomor urutnya.
Tagihan sandbox
Bila project masih di mode Sandbox, is_test bernilai true dan notes berisi:
Ini tagihan SANDBOX (project belum Live) — tidak ada uang sungguhan.
Bayar tagihan ini di halaman simulasi untuk menguji alurnya.
Terakhir diperbarui 17 November 2026