# Aulaa Payment Gateway

> Aulaa adalah platform agregator pembayaran dan Payment Gateway di Indonesia yang menyediakan solusi Payment Link (no-code) dan REST API developer untuk menerima pembayaran QRIS, Virtual Account (BCA, BRI, Mandiri, BNI, Permata, dll.), E-Wallet (DANA, OVO, ShopeePay, GoPay), serta Kartu Kredit/Debit.

## Quick Links for LLMs & AI Agents

- [Full API Reference & Integration Guide](https://aulaa.co/llms-full.txt): Dokumentasi teknis API lengkap dalam format Markdown murni untuk AI/LLM.
- [Dokumentasi API Web](https://aulaa.co/dokumentasi): Halaman dokumentasi interaktif untuk developer.
- [Panduan Merchant & KYC](https://aulaa.co/panduan): Panduan verifikasi KYC, pembuatan project, dan penarikan saldo (payout).
- [Plugin WooCommerce](https://aulaa.co/woocommerce): Panduan integrasi payment gateway Aulaa pada toko online WordPress/WooCommerce.
- [Biaya & Pricing](https://aulaa.co/biaya): Rincian biaya MDR QRIS, Virtual Account, dan settlement.

## API Summary

- **Base URL**: `https://api.aulaa.co/v1` (sama untuk Sandbox dan Production)
- **Sandbox vs Production**: ditentukan oleh **switch mode pada Project**, BUKAN oleh host atau API key yang berbeda. Project bermode test memakai konektor simulasi; project yang sudah di-review dan di-Go Live memproses transaksi sungguhan. Satu API key berlaku untuk keduanya.
- **Authentication**: Bearer Token via Header `Authorization: Bearer pgw_id_xxxxxxxxxxxxxxxx`
- **Content-Type**: `application/json`

### Core Endpoints

1. `POST /v1/payments` - Membuat transaksi pembayaran baru (QRIS dinamis, Virtual Account, E-Wallet, atau checkout URL). Idempoten berdasarkan `order_id`.
2. `GET /v1/payments/methods` - Mengambil daftar metode pembayaran yang aktif dan batas minimum/maksimum nominal.
3. `GET /v1/payments/{id}` - Memeriksa status transaksi pembayaran secara real-time.
4. `POST /v1/payments/{id}/cancel` - Membatalkan transaksi pembayaran yang masih berstatus `pending`.

### Webhook & Notification
- Aulaa mengirimkan HTTP POST event ke `callback_url` project saat status pembayaran berubah (`paid`, `expired`, `failed`).
- Signature verifikasi menggunakan header `X-Webhook-Signature`, berisi HMAC-SHA256 atas **raw request body** dengan `webhook_secret` milik project. Header yang sama juga dipakai webhook penarikan (Disbursement API), dengan skema perhitungan yang identik.

Untuk dokumentasi lengkap beserta contoh payload request/response JSON dan implementasi kode (Node.js, Python, PHP, Go, cURL), silakan rujuk ke `https://aulaa.co/llms-full.txt`.