Pembayaran uji

Sandbox memakai provider simulasi agar kamu bisa mencoba alur pembayaran tanpa uang sungguhan. Pastikan dashboard menunjukkan Sandbox sebelum mulai.

Simulasikan akhir sebuah pembayaran

Dengan test key, pembayaran yang pending berakhir sesuai perintahmu:

curl "https://api.baiyar.com/v1/sandbox/payments/$PAYMENT_ID/simulate" \
  -H "Authorization: Bearer $BAIYAR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "outcome": "paid" }'

outcome	Hasil
paid	Pembayaran lunas; payment.succeeded dikirim, lalu settlement menyusul.
failed	Pembayaran gagal; payment.failed dikirim.
expired	Pembayaran kedaluwarsa tanpa dibayar; payment.expired dikirim.

Live key tidak bisa memakai endpoint ini.

Di dasbor kamu bisa melakukan hal yang sama: di sandbox, buka pembayaran yang menunggu di Transaksi dan tentukan bagaimana pembayaran itu berakhir.

Uji endpoint webhook-mu

• Daftarkan endpoint (HTTPS publik; pakai tunnel dari laptop) dan tekan Test untuk menerima event webhook.test.
• Jalankan skenario dari Developer Tools → Simulasi ke endpoint-mu. Sandbox mengirim event untuk pembayaran sukses, gagal, kedaluwarsa, event tidak berurutan, dan event yang sama dua kali. Skenario ini tidak membuat pembayaran tersimpan. Lihat Webhook.
• Verifikasi tanda tangan persis seperti di produksi: di sandbox sama.

Yang diperiksa sebelum go live

1. Kode pembayaranmu mengirim Idempotency-Key dan menyimpan id pembayaran bersama order.
2. Handler webhook-mu memverifikasi tanda tangan atas raw body, menjawab 2xx dengan cepat, mengabaikan id event yang berulang, dan membaca status pembayaran saat ini, bukan mengandalkan urutan event.
3. Kamu menangani setiap kode error yang mungkin muncul, lewat error.code (lihat Error).
4. Live key ada di secret store, bukan di kode, dan dibatasi ke alamat server-mu.