Pengantar

Apa yang dilakukan Baiyar, bagaimana sandbox dan live bekerja, dan jalan dari mendaftar sampai pembayaran live pertamamu.

Baiyar menerima pembayaran QRIS, virtual account, e-wallet, dan gerai ritel. Kamu bisa membuat payment link di dashboard atau membuat pembayaran dari server lewat Merchant API.

	Sandbox	Live
Host	`https://api.baiyar.com`	`https://api.baiyar.com`
Key	`bk_test_…`	`bk_live_…`
Uang	tidak ada: pembayaran disimulasikan	sungguhan

Data sandbox dan live terpisah. Pembayaran, link, saldo, dan endpoint webhook dari satu environment tidak muncul di environment lainnya. Keduanya memakai satu host: key yang kamu kirim menentukan environment yang dituju.

Alur sebuah pembayaran

Server membuat pembayaran lewat POST /v1/payments dengan nominal dan metode.
Baiyar mengembalikan instruksi pembayaran, seperti kode QR, nomor virtual account, tautan e-wallet, atau kode gerai.
Pembayar menyelesaikan pembayaran melalui bank atau wallet-nya.
Baiyar mengubah status menjadi paid dan mengirim webhook payment.succeeded. Kamu juga bisa membaca status terbaru lewat GET /v1/payments/{id}.
Setelah Baiyar mencocokkan bukti settlement provider, dana berpindah dari saldo tertunda ke saldo tersedia dan Baiyar mengirim payment.settled.

Status pembayaran bergerak dari created ke pending, lalu berakhir sebagai paid, failed, atau expired. Status paid berarti pembayar berhasil; settlement terjadi sesudahnya.

Jalannya

Buat akun dan jaga keamanannya.
Buat proyek di sandbox dan ambil test API key.
Buat pembayaran pertamamu, bagikan payment link atau kirim invoice, dan ketahui pembayaran lewat webhook. Pembayaran uji menunjukkan cara mencoba setiap hasil.
Verifikasi akunmu dan go live.
Ikuti pembayaran dan saldomu, dan rawat akunmu di Pengaturan.

Untuk detail tiap operasi, buka Referensi API. Aturan umum request dan respons ada di Konvensi.