Langsung ke konten
Fintar Checkout

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.

Buat sesi checkoutPOST /v1/transactions
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...", ... }
Cara kerja

Satu request, satu redirect.

  1. Buat transaksi

    Kirim POST /v1/transactions dengan isi pesanan dan return_url. Respons memuat checkout_url.

  2. Redirect pembeli

    Arahkan pembeli ke checkout_url. Pembeli memilih QRIS atau Virtual Account dan membayar di halaman itu.

  3. Terima webhook

    Event payment.paid dikirim ke server, dan pembeli kembali ke return_url.

Yang bisa diatur

Halaman 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.
FAQ

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.