Fintar Checkout: halaman pembayaran yang tinggal di-redirect.
Buat transaksi, arahkan pembeli ke checkout_url, dan tunggu webhook. Fintar yang menampilkan pilihan metode, kode QRIS, nomor Virtual Account, dan status pembayaran.
Cara tercepat memasang pembayaran di website atau aplikasi.
curl https://api.fintar.id/v1/transactions \
-H "Authorization: Bearer ft_test_..." \
-H "Idempotency-Key: order-1234" \
-H "Content-Type: application/json" \
-d '{
"order_items": [
{ "name": "Kaos polos", "price": 75000, "quantity": 2 }
],
"external_id": "ORD-1234",
"return_url": "https://toko.example/selesai",
"customer": { "name": "Budi", "email": "budi@toko.dev" }
}'
# 201: redirect the buyer to checkout_url
# { "id": "payreq_9b2f...", "checkout_url": ".../p/xK3f...", ... }
Satu request, satu redirect.
Buat transaksi
Kirim POST /v1/transactions dengan isi pesanan dan return_url. Respons memuat checkout_url.
Redirect pembeli
Arahkan pembeli ke checkout_url. Pembeli memilih QRIS atau Virtual Account dan membayar di halaman itu.
Terima webhook
Event payment.paid dikirim ke server, dan pembeli kembali ke return_url.
Fintar Checkout atau Direct API?
Keduanya memakai endpoint yang sama. Bedanya hanya siapa yang menampilkan halaman pembayaran.
Fintar Checkout
Paling cepat dipasang. Halaman pembayaran di-host dan dikelola Fintar, dan pembeli memilih metodenya sendiri. Cocok untuk sebagian besar toko online.
Dokumentasi CheckoutDirect API
Kendali penuh atas tampilan. Kode QRIS atau nomor Virtual Account ditampilkan di halaman sendiri, tanpa redirect.
Dokumentasi Direct APIHalaman siap pakai yang tetap mengikuti alur bisnis.
- Kumpulkan data pembeli. Minta nama dan email di halaman checkout, dan tentukan mana yang wajib.
- Isi data dari awal. Kirim data pembeli yang sudah diketahui supaya pembeli tidak mengetik ulang.
- Batasi metode. Tawarkan semua metode yang aktif, atau hanya yang dipilih lewat payment_methods.
- Kembali ke toko. Setelah membayar, pembeli diarahkan ke return_url.
Pertanyaan tentang Fintar Checkout
Apa beda Fintar Checkout dan Direct API?
Pada Fintar Checkout, pembeli diarahkan ke halaman pembayaran yang di-host Fintar. Pada Direct API, kode QRIS atau nomor Virtual Account ditampilkan di halaman merchant sendiri. Keduanya memakai endpoint dan webhook yang sama.
Apakah perlu membuat tampilan pembayaran sendiri?
Tidak. Fintar Checkout sudah menampilkan pilihan metode, instruksi pembayaran, dan status. Server hanya perlu membuat transaksi dan menerima webhook.
Metode apa yang muncul di halaman checkout?
QRIS dan Virtual Account yang aktif di akun. Daftar metode bisa dibatasi per transaksi lewat payment_methods.
Bagaimana website tahu pembayaran sudah berhasil?
Lewat webhook payment.paid yang dikirim ke server. Jangan mengandalkan redirect ke return_url saja, karena pembeli bisa menutup halaman sebelum kembali.
Bisakah Fintar Checkout diuji tanpa uang sungguhan?
Bisa. Dengan test key berawalan ft_test_, halaman checkout berjalan di Sandbox dan pembayaran bisa disimulasikan.
Pasang pembayaran tanpa membangun halaman bayar.
Buat akun, ambil test key, dan arahkan pembeli pertama ke Fintar Checkout.