Identifier

Awalan identifier Baiyar, dan cara bekerja dengannya.

Setiap objek punya id yang diawali awalan jenisnya, lalu _, lalu 26 karakter (huruf kecil dan angka). Misalnya pay_01k7q3m8x2v5t9n4b6c1d0e7fa.

Awalan ID

Awalan	Objek
`mer_`	Merchant
`prj_`	Proyek
`apk_`	API key
`pay_`	Pembayaran
`lnk_`	Payment link
`att_`	Percobaan pembayaran
`inv_`	Invoice
`whk_`	Endpoint webhook
`wev_`	Event webhook
`wdl_`	Pengiriman webhook

Bekerja dengan identifier

Perlakukan id sebagai teks utuh: simpan dan bandingkan seluruh nilainya. Jangan mengurai panjang atau karakter setelah awalan. Awalan menunjukkan jenis objek, dan id hanya diterima pada tempat yang mengharapkan jenis itu.

Membuat objek

Kamu tidak memilih id: id ada di jawaban request yang membuat objeknya, di data. Simpan id sebuah pembayaran bersama ordermu.

{ "data": { "id": "pay_01k7q3m8x2v5t9n4b6c1d0e7fa", "status": "pending", "merchant_reference": "order-1001" }, "meta": { "request_id": "req_…" } }

Mengambil objek

Taruh id di path: GET /v1/payments/pay_01k7q3m8x2v5t9n4b6c1d0e7fa. Untuk mencari pembayaran dengan referensimu sendiri, daftar dengan filter merchant_reference.

Menghubungkan objek

Sebuah objek menyebut objek tempat ia berada lewat id-nya: pembayaran punya project_id, dan payment_link_id kalau dibuat lewat link, dan event bisa dicari lewat payment_id atau payment_link_id.

GET /v1/events?payment_id=pay_01k7q3m8x2v5t9n4b6c1d0e7fa

Mengurutkan dengan id

Id juga urutan waktunya: id terurut menurut kapan objek dibuat. Daftar datang terbaru dahulu, dan kamu berpindah halaman dengan id item terakhir yang kamu punya (lihat Paginasi).

Environment

Bentuk id sama di sandbox dan live, tetapi sebuah objek hanya milik satu environment: id pembayaran sandbox tidak ditemukan dengan live key.