Plugin WooCommerce

Plugin resmi ini menambahkan Fintar sebagai metode pembayaran di checkout toko Anda. Pembeli di-redirect ke halaman Fintar Checkout untuk membayar, lalu pesanan otomatis ditandai lunas lewat webhook payment.paid yang ber-signature. Source code dan file download-nya ada di GitHub. Checkout block (default WooCommerce) maupun halaman shortcode [woocommerce_checkout] dua-duanya didukung.

Requirement

WordPress 6.0+, WooCommerce 8.0+, PHP 8.1+, dan mata uang toko IDR — di mata uang lain, metode pembayaran ini otomatis disembunyikan.

Instalasi

Download zip terbaru dari Releases, lalu di admin WordPress: Plugins → Add New → Upload Plugin, dan aktifkan.

Pengaturan

Buka WooCommerce → Settings → Payments → Fintar dan isi dua nilai:

API key. Dari halaman Developer di dashboard. Mulai dengan ft_test_... — semuanya jalan dari awal sampai akhir dan tidak ada uang sungguhan yang berpindah; lihat Test mode.

Webhook signing secret. Di dashboard, atur URL webhook ke https://toko-anda.com/?wc-api=fintar lalu salin secret whsec_... ke pengaturan plugin. Tanpa ini, pesanan tidak akan berubah ke Processing sendiri.

Kolom kode metode yang opsional membatasi metode yang ditawarkan di checkout (kode dipisah koma, daftarnya di metode pembayaran); kosong berarti semua metode yang aktif di akun Anda.

Test dulu, lalu go live

Buat satu pesanan dengan test key: pilih Fintar di checkout, bayar di halaman Fintar (di test mode ada tombol Simulasikan pembayaran), dan pastikan pesanan berubah jadi Processing. Setelah itu ganti key-nya dengan ft_live_.... Selesai — itu seluruh proses go-live-nya.

Yang dikerjakan plugin di belakang layar

Setiap pesanan membuat payment request lewat POST /v1/transactions dengan Idempotency-Key yang dibuat dari pesanan dan body request-nya, jadi tombol bayar yang terklik dua kali tidak pernah menagih dua kali. Webhook diverifikasi dengan Fintar-Signature-V1 (HMAC dengan timestamp, toleransi lima menit) sebelum pesanan diubah, dan kiriman webhook yang nominalnya tidak cocok dengan total pesanan membuat pesanan ditahan (on hold), bukan diselesaikan.

Kalau ada yang tidak jalan

Fintar tidak muncul di checkout: pastikan mata uang toko IDR dan kolom API key terisi. Pesanan tetap Pending setelah dibayar: periksa URL webhook di dashboard dan signing secret di plugin — pembayarannya sudah berhasil di sisi Fintar; yang belum sampai hanya notifikasinya, dan webhook-nya di-retry sampai tujuh kali dalam sekitar 33 jam.