Menu dokumentasi

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_id yang 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