Langsung ke konten
Virtual Account API

Virtual Account API: nomor VA unik untuk setiap pesanan.

Pembeli transfer ke nomor Virtual Account dari aplikasi banknya, dan pesanan ditandai lunas otomatis. Tidak perlu lagi cek mutasi atau minta bukti transfer.

Uji dulu dengan test key, tanpa uang sungguhan.

Buat Virtual AccountPOST /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",
    "payment_methods": ["va_mandiri"],
    "customer": { "name": "Budi", "email": "budi@toko.dev" }
  }'
Cara kerja

Tiga langkah dari pesanan ke lunas.

  1. Buat transaksi

    Kirim POST /v1/transactions dengan kode bank, misalnya va_bni atau va_mandiri, dan nama pembeli.

  2. Tampilkan nomor VA

    Respons memuat payment_code dan nama bank. Tampilkan keduanya bersama nominal di halaman pembayaran.

  3. Terima webhook

    Event payment.paid dikirim ke server setelah transfer diterima. Pesanan bisa langsung diproses.

Yang didapat

Satu request yang sama untuk setiap bank.

  • Tujuh bank. BRI, BNI, Mandiri, Permata, CIMB Niaga, Danamon, dan Maybank.
  • Satu kode per bank. Setiap bank adalah request yang sama dengan kode berbeda di payment_methods.
  • Nama pembeli wajib. Virtual Account menampilkan nama pembeli, jadi customer.name harus diisi.
  • Rp10.000 sampai Rp10.000.000. Batas nominal default per pembayaran. Butuh maksimum lebih besar? Email halo@fintar.id.
  • Nominal terkunci. Setiap nomor VA terikat pada satu transaksi dan satu nominal.
Respons201 Created
{
  "id": "payreq_9b2f...",
  "status": "pending",
  "payment_method": "va_mandiri",
  "payment": {
    "type": "payment_code",
    "payment_code": "8890812345678901",
    "bank": "Mandiri",
    "display_name": "Mandiri Virtual Account"
  },
  "expires_at": "2026-08-28T12:00:00+07:00"
}
Dasar

Kenapa Virtual Account, bukan transfer manual?

Pada transfer manual, pembeli mengirim uang ke rekening biasa lalu mengirim bukti transfer. Penjual harus membuka mutasi, mencocokkan nominal, dan menandai pesanan satu per satu.

Virtual Account adalah nomor tujuan transfer yang dibuat khusus untuk satu pesanan. Begitu pembeli membayar ke nomor itu, sistem langsung tahu pesanan mana yang lunas.

Dengan Virtual Account API Fintar, nomor VA dibuat lewat satu request dan hasilnya dikirim ke server lewat webhook. Pencocokan pembayaran berjalan tanpa pekerjaan manual.

FAQ

Pertanyaan tentang Virtual Account API

Bank apa saja yang didukung Virtual Account Fintar?

BRI, BNI, Mandiri, Permata, CIMB Niaga, Danamon, dan Maybank. Bank yang aktif untuk sebuah akun selalu bisa dicek lewat GET /v1/payment_methods.

Berapa nominal minimum dan maksimum Virtual Account?

Minimum Rp10.000 dan maksimum Rp10.000.000 per pembayaran. Untuk maksimum yang lebih besar, email halo@fintar.id.

Apakah pembeli bisa membayar dari bank lain?

Nomor Virtual Account dibayar lewat bank penerbitnya. Untuk pembeli yang memakai bank atau e-wallet lain, tawarkan juga QRIS, yang bisa dibayar dari aplikasi mana pun yang mendukung QRIS.

Bagaimana menguji Virtual Account tanpa uang sungguhan?

Pakai test key berawalan ft_test_. Di Sandbox, pembayaran bisa disimulasikan berhasil atau kedaluwarsa tanpa transfer sungguhan.

Apakah pembayaran Virtual Account bisa di-refund?

Pembayaran Virtual Account tidak bisa dibalik atau di-refund lewat Fintar. Pengembalian dana ditransfer merchant dari rekening bank sendiri, di luar Fintar.

Berhenti mencocokkan bukti transfer.

Buat akun, ambil test key, dan buat nomor Virtual Account pertama dalam beberapa menit.