Quickstart

1. Daftar dan buat API key

Daftar di halaman daftar, lalu buka Profil → API Key dan buat key baru. Key hanya ditampilkan sekali, simpan di server.

2. Buat invoice

curl -X POST https://pay.tokomu.id/api/invoices \
  -H "X-API-Key: ngp_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"amount": 25000, "order_id": "INV-1001", "description": "Kopi susu"}'

Respons 201:

{
  "id": "9f2c1a7b3e5d8a41c0b2",
  "order_id": "INV-1001",
  "amount": 25000,
  "total": 25000,
  "status": "pending",
  "expires_at": 1767225600,
  "pay_url": "https://pay.tokomu.id/pay.html?id=9f2c1a7b3e5d8a41c0b2"
}

3. Tampilkan pembayaran

Redirect pelanggan ke pay_url. Halaman itu menampilkan QR, hitung mundur, dan berubah otomatis saat lunas.

4. Uji di sandbox

Bila layanan berjalan di mode sandbox, halaman bayar menampilkan tombol Simulasikan pembayaran. Lihat Sandbox.

5. Terima webhook

Isi URL webhook di dasbor, lalu proses event invoice.paid. Panduan lengkap ada di Webhook.