Payment link

Payment link adalah halaman checkout tempat pembayar memilih metode yang tersedia dan membayar. Bagikan URL-nya; Baiyar menampilkan instruksi pembayaran dan mencatat hasilnya.

Di dashboard

1. Pilih Payment Link di menu lalu Buat payment link. Link berada di sebuah proyek, jadi buat proyek dulu kalau belum punya.

   

2. Isi yang pokok: judul yang dilihat pembayar (nama produk atau nomor invoice), deskripsi opsional, dan nominal: nominal tetap, atau pembeli mengisi di antara minimum dan maksimum. Yang dilihat pembayar berubah di samping formulir saat kamu mengetik.

   

3. Buka opsi lanjutan kalau perlu: Izinkan banyak pembayaran (link yang bisa dipakai ulang, boleh dibatasi), Berlaku sampai (tanpa batas waktu, besok, 7 atau 14 hari, atau tanggal tertentu), data pembeli yang diminta (nama, email, telepon, alamat), penanggung biaya (pakai pengaturan proyek, kamu, atau pembayar), dan referensimu sendiri.

   

4. Buat. Layar berikutnya adalah Link siap dibagikan: Salin link, Unduh QR, Bagikan lewat WhatsApp, atau Buka sebagai pembeli untuk melihat yang dilihat pelangganmu.

   

Link tidak bisa diedit setelah dibuat. Pilih Duplikat untuk membuat versi baru. Aturan biaya dikunci saat link dibuat, sehingga perubahan harga Baiyar tidak mengubah link yang sudah ada.

Pilih Batalkan link untuk menghentikan pembayaran baru. Pembayaran yang sudah dibuka dari link masih bisa diselesaikan. Halaman link dan Transaksi menampilkan pembayaran tersebut.

Pembayar membuka link, biasanya di ponsel. Mereka melihat nominal dan metode yang kamu sediakan, lalu kode QR atau nomor virtual account, lalu struk. Di sandbox ada bilah di bawah untuk menentukan bagaimana pembayaran uji berakhir.

Untuk menagih pelanggan dengan rincian barang, pajak, dan jatuh tempo, pakai invoice.

Dengan API

Buat link dengan POST, bagikan url yang dikembalikan, lalu pakai GET untuk memeriksa statusnya. Kamu juga bisa membatalkan link. Lihat referensi API untuk operasi buat, lihat, dan batalkan.

curl "https://api.baiyar.com/v1/payment-links" \
  -H "Authorization: Bearer $BAIYAR_KEY" \
  -H "Idempotency-Key: invoice-2041" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Invoice 2041",
    "amount": 25000000,
    "usage": "single_use",
    "fee_bearer": "merchant"
  }'

Contoh ini memakai BAIYAR_KEY berupa project key. Jika memakai merchant key, sertakan project_id link di request. Respons berisi url untuk dibagikan, state saat ini, dan stats penggunaannya.

Pilihan

Field	Arti
amount	Nominal tetap. Atau pakai min_amount dan max_amount agar pembayar mengisi nominal dalam rentang itu. Nominal memakai satuan terkecil IDR: Rp25.000 adalah 25000000.
usage	single_use: satu pembayaran, lalu link selesai. reusable: banyak pembayaran, bisa dibatasi dengan max_uses.
max_uses	Batas pembayaran pada link reusable. Pembayaran yang masih terbuka dan yang sudah lunas sama-sama dihitung.
payment_methods	Metode yang boleh dipilih pembayar. Bawaannya semua metode proyek.
fee_bearer	merchant: kamu yang menanggung fee. customer: fee ditambahkan untuk pembayar. Jika dikosongkan, pengaturan proyek berlaku. Fee dikunci saat link dibuat, jadi perubahan harga kemudian tidak mengubahnya.
customer_fields	Apakah meminta name, email, phone, dan address: off, optional, atau required. Field yang tidak disebutkan bawaannya off.
expires_at	Waktu link berhenti menerima pembayaran, dalam ISO 8601.
after_payment, redirect_url, confirmation_message	Pilih halaman konfirmasi Baiyar (bawaan) atau pengalihan ke situsmu. redirect_url menentukan tujuan; confirmation_message mengatur teks pada halaman konfirmasi.
reference	Referensimu sendiri. Kalau dikosongkan, kami membuatkan.

Memantau

• GET /v1/payment-links/{id} menunjukkan state (payable, in_use, completed, expired, atau cancelled) dan jumlah pembayarannya.
• Tiap pembayaran lewat link adalah pembayaran biasa dengan payment_link_id terisi, jadi webhook payment.succeeded bekerja seperti biasa. Linknya sendiri mengirim payment_link.completed, payment_link.expired, dan payment_link.cancelled.
• POST /v1/payment-links/{id}/cancel menghentikan pembayaran baru; pembayaran yang sudah ada tetap.

Link sekali pakai hanya menerima satu pembayaran terbuka pada satu waktu, jadi dua pembayar tidak bisa membayar link yang sama bersamaan.