Nyaur Docs

Dari daftar sampai checkout sandbox pertama, produk, token, checkout, dan webhook.

Panduan ini membawa kamu dari akun kosong sampai pembayaran sandbox pertama. Mode sandbox memakai driver DOKU mock: payload QRIS dan nomor virtual account disimulasikan, dan aksi "Simulasikan pembayaran" di halaman checkout melunasi transaksi tanpa uang sungguhan.

1. Daftar dan buat organisasi

Daftar di nyaur.id, lalu buat organisasi. Tipe organisasi menentukan buku biaya:

Indonesia untuk developer dengan KTP atau badan usaha Indonesia.
International untuk penjual tanpa entitas Indonesia yang menjual ke Indonesia.

2. Buat token API sandbox

Buka Pengaturan, API Tokens di dashboard dan buat token dengan mode sandbox. Token berawalan nyaur_oat_ dan hanya ditampilkan sekali. Lihat Authentication.

3. Buat produk

Semua yang kamu jual adalah produk. Harga dikirim sebagai array prices.

curl -X POST https://api.nyaur.id/v1/products \
  -H "Authorization: Bearer $NYAUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "API Credits",
    "description": "10.000 API credits per bulan",
    "status": "active",
    "prices": [
      { "type": "fixed", "amount": 79000, "recurring": "month", "intervalCount": 1 }
    ]
  }'

Respons memuat id produk dan prices[].id. Detail lengkap ada di Products dan prices.

4. Buat checkout

curl -X POST https://api.nyaur.id/v1/checkouts \
  -H "Authorization: Bearer $NYAUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "productId": "prd_xxx",
    "customerEmail": "pembeli@example.com",
    "locale": "id"
  }'

Respons berisi subtotal, ppn, dan total dalam rupiah, serta expiresAt (60 menit). Untuk halaman bayar yang bisa dibagikan, buat checkout link di dashboard, lalu buka https://nyaur.id/checkout/<slug>. Pembeli memilih QRIS atau virtual account (BCA, BNI, BRI). Di sandbox, tekan "Simulasikan pembayaran". Lihat Checkout.

5. Dengarkan webhook

curl -X POST https://api.nyaur.id/v1/webhooks \
  -H "Authorization: Bearer $NYAUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://contoh.id/webhooks/nyaur",
    "events": ["checkout.paid", "order.paid", "benefit.granted"]
  }'

Signing secret nyaur_whsec_... hanya muncul sekali. Verifikasi tanda tangan seperti di Webhooks sebelum memercayai payload.

Checkout yang lunas memicu, berurutan:

checkout.paid: sesi lunas.
order.paid: order dan invoice sudah ada, lengkap dengan rincian biaya.
benefit.granted: satu per benefit, misalnya license key pembeli.

Selanjutnya

Dana masuk ke saldo pending selama 7 hari setelah pembayaran, lalu menjadi tersedia.
Sebelum payout pertama, selesaikan KYC dan tambahkan rekening bank atas nama yang sama. Pembeli tetap bisa membayar selama verifikasi berjalan.
Checkout live baru terbuka setelah review produk (Gate 1) lulus. Lihat Sandbox vs live.

Error

Error /v1 selalu berbentuk {"error":{"type","message"}}. Batas laju 300 permintaan per menit per organisasi; saat 429, tunggu sesuai header Retry-After.

Quickstart