Tipe data
Cara API Baiyar menulis nominal, mata uang, waktu, boolean, nilai null, dan teks.
amount adalah bilangan bulat dalam satuan terkecil mata uang. Untuk rupiah, Rp10.000 dikirim sebagai 1000000, karena ISO 4217 menetapkan dua angka desimal untuk rupiah. Kirim amount bersama currency, dan jangan kirim nilai desimal.
{ "amount": 1000000, "currency": "IDR" }Pembayaran menggunakan rupiah bulat, jadi amount harus berupa kelipatan 100.
| Dalam rupiah | amount yang dikirim |
|---|---|
| Rp1.000 | 100000 |
| Rp10.000 | 1000000 |
| Rp125.000 | 12500000 |
| Rp1.500.000 | 150000000 |
Kalikan nilai rupiah dengan 100 untuk mendapat amount. Bagi amount dengan 100 untuk menampilkan nilai rupiah. Gunakan bilangan bulat saat menghitung uang; jangan gunakan floating point.
Kode mata uang
Section titled “Kode mata uang”Mata uang adalah kode ISO 4217 dengan huruf kapital. Merchant API menerima pembayaran dalam IDR.
Tanggal dan waktu
Section titled “Tanggal dan waktu”Waktu memakai ISO 8601 UTC, dengan milidetik dan Z:
{ "created_at": "2026-10-26T03:04:05.000Z" }Field created pada event webhook memakai Unix timestamp dalam satuan detik. Tampilkan waktu dalam zona waktu pengguna (WIB, WITA, atau WIT di Indonesia).
Boolean
Section titled “Boolean”true atau false, bukan string. livemode menunjukkan apakah sebuah objek milik live (true) atau sandbox (false).
Nilai null
Section titled “Nilai null”Field tanpa nilai dikirim sebagai null; nama field tetap ada di respons. Contohnya, pembayaran tanpa link memiliki "payment_link_id": null, sedangkan pembayaran yang belum lunas memiliki "paid_at": null. Dalam request, field opsional boleh tidak disertakan.
String dan enum
Section titled “String dan enum”Teks berupa UTF-8. Field dengan himpunan nilai tetap, seperti status pembayaran, memakai kata huruf kecil (created, pending, paid, failed, expired); halaman referensi operasinya mendaftarkannya.
Metadata
Section titled “Metadata”Objek berisi teks milikmu sendiri: lihat Metadata.