Menu dokumentasi

API Call

Server Anda membuat tagihan lewat API, lalu mengarahkan pelanggan ke link pembayarannya.

Dengan API Call, server Anda yang membuat tagihan dengan memanggil API Aulaa. Response-nya membawa payment_link, lalu Anda arahkan pelanggan ke link itu. Pelanggan membayar di halaman pembayaran Aulaa yang sama dengan Payment Link dari Dashboard.

Bedanya ada di urutan: pada API Call, tagihan sudah tercatat di Aulaa sebelum pelanggan membuka link. Karena itu sistem Anda bisa mengatur tagihannya, mengecek statusnya, dan membatalkannya lewat kode.

Alurnya

  1. Pelanggan menyelesaikan pesanan di website atau aplikasi Anda.
  2. Server Anda memanggil POST /v1/payments dengan order_id dan amount.
  3. Aulaa membalas dengan id tagihan dan payment_link.
  4. Server Anda mengarahkan pelanggan ke payment_link.
  5. Pelanggan membayar. Aulaa mengirim webhook ke server Anda, lalu mengalihkan pelanggan ke redirect_url Anda (bila diisi).
app.post('/checkout', async (req, res) => {
  const response = await fetch('https://api.aulaa.co/v1/payments', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.AULAA_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      order_id: req.body.orderId,
      amount: req.body.total,
      redirect_url: 'https://toko-anda.com/checkout/sukses',
    }),
  });
  const payment = await response.json();

  // Simpan payment.id bersama pesanan Anda, lalu arahkan pelanggan ke link pembayaran.
  res.redirect(303, payment.payment_link);
});

Yang Anda dapat dari API Call

  • Tagihan tercatat dengan order_id Anda. order_id unik per project, jadi pelanggan tidak mungkin tertagih dua kali untuk pesanan yang sama.
  • Bisa mengunci metode pembayaran lewat payment_method, atau membiarkan pelanggan memilih sendiri.
  • Bisa mengecek status dan membatalkan tagihan kapan saja.

Yang Anda perlukan

  1. Project tipe API dengan URL webhook terisi. Project tipe No-Code tidak bisa memakai API.
  2. API Key project tersebut.
  3. Server/backend. API Key tidak boleh berada di kode browser atau aplikasi mobile.
  4. Endpoint webhook di server Anda untuk menerima kabar lunas.

Urutan baca yang disarankan: Akun & API Key, Buat Pembayaran, lalu Webhook.

Terakhir diperbarui 23 Oktober 2026