Manfaatkan Custom Payment Flow pada Self-Hosted Payment Gateway

Table of Contents

Custom Payment Flow API adalah metode integrasi pembayaran yang memungkinkan Anda mengatur tampilan, interaksi, dan alur pembayaran sesuai kebutuhan website atau aplikasi tanpa mengarahkan pelanggan ke halaman eksternal. Melalui DOKU Direct API, merchant dapat menyesuaikan UI checkout, mengatur tampilan metode pembayaran, serta membangun business logic untuk menangani berbagai status transaksi, seperti Paid, Pending, dan Failed.

Proses integrasinya meliputi konfigurasi API, pemilihan metode pembayaran, pemrosesan transaksi melalui infrastruktur DOKU, hingga pembaruan status melalui webhook. Solusi ini cocok bagi bisnis Anda yang membutuhkan pengalaman pembayaran terintegrasi dan kustomisasi mendalam, sedangkan DOKU Checkout dapat menjadi alternatif untuk kebutuhan yang lebih sederhana. Untuk lebih detailnya, simak panduan fitur custom payment flow API berikut ini!

Apa Itu Custom Payment Flow API?

Custom payment flow API adalah pendekatan integrasi yang memberikan pemilik bisnis kontrol lebih besar terhadap bagaimana proses pembayaran dibangun di dalam website atau aplikasi. Tak lagi bergantung sepenuhnya pada halaman checkout yang disediakan payment provider, Anda dapat mengembangkan UI dan alur pembayaran sesuai kebutuhan platform.

Konsep ini dapat digunakan untuk berbagai skenario pembayaran. Dalam DOKU Direct API, Anda diberikan kontrol penuh kepada bisnis untuk merancang antarmuka dan user journey transaksi tanpa mengalihkan pelanggan (redirection) keluar dari platform. Seluruh pengumpulan informasi pembayaran dilakukan di sisi merchant, sementara infrastruktur DOKU memproses transaksi di balik layar secara aman sesuai standar PCI DSS.

Kustomisasi UI dan Layout untuk Payment Flow

Salah satu alasan bisnis memilih Direct API adalah kebutuhan untuk menyesuaikan UI dan layout dengan pengalaman digital yang sudah mereka miliki. Halaman pembayaran dapat dirancang agar tetap konsisten dengan visual website atau aplikasi, termasuk struktur halaman, urutan informasi dan posisi elemen interaksi.

Anda dapat menentukan bagaimana informasi seperti ringkasan order, nominal pembayaran, pilihan metode pembayaran dan tombol konfirmasi disusun. Tujuannya bukan sekadar membuat checkout lebih menarik, tetapi memastikan pelanggan memahami apa yang harus dilakukan pada setiap tahap.

Misalnya, bisnis dapat memilih untuk menampilkan ringkasan pesanan sebelum metode pembayaran atau menambahkan halaman review sebelum transaksi dikonfirmasi.

Namun, semakin banyak elemen UI yang dikustomisasi secara mandiri, semakin besar pula tanggung jawab tim developer Anda dalam memastikan akses dan respons di berbagai perangkat.

Mengatur Interaction dan Business Logic

Custom payment flow juga memberikan ruang untuk mengatur interaction sesuai dengan kebutuhan bisnis. Interaksi pelanggan dapat dirancang berdasarkan kondisi transaksi, metode pembayaran atau tahapan yang harus dilalui sebelum order dianggap selesai.

Di sinilah business logic menjadi penting. Anda perlu menentukan apa yang terjadi setelah pelanggan memilih metode pembayaran, mengirim informasi pembayaran atau menyelesaikan proses autentikasi. Sistem juga perlu mengetahui kapan order dapat dianggap berhasil dan kapan transaksi masih menunggu status akhir.

Dalam alur pemrosesan transaksi seperti Virtual Account atau QRIS, status pembayaran tidak selalu berubah seketika. DOKU menyediakan pemberitahuan status alias webhook dan DOKU Dashboard yang terpusat. Hal tersebut sangat membantu untuk memantau perubahan status transaksi secara real-time agar logika backend dapat merespons dengan cepat.

Tampilan Metode Pembayaran

Pilihan metode pembayaran juga menjadi bagian penting dalam custom payment flow. Anda dapat merancang bagaimana metode pembayaran ditampilkan atau mengatur method display. Sehingga pelanggan dapat memahami pilihan yang tersedia tanpa membuat halaman checkout terlalu kompleks.

Urutan dan cara menampilkan metode pembayaran dapat disesuaikan dengan kebutuhan bisnis. Misalnya, metode yang paling sering digunakan dapat ditempatkan lebih menonjol, sementara metode lain dapat dikelompokkan berdasarkan kategori tertentu.

Testing dan Batasan Custom Payment Flow

Semakin fleksibel payment flow yang dibangun, semakin penting proses testing dilakukan sebelum digunakan oleh pelanggan. Anda perlu menguji bukan hanya kondisi pembayaran berhasil, tetapi juga pending, failed, perubahan status dan kemungkinan pelanggan mengulangi proses pembayaran.

Implementasi alur pembayaran mandiri memerlukan tahap pengujian menyeluruh. Sebelum mengaktifkan go-live, Anda perlu menguji skenario transaksi baik yang sukses atau gagal.

Status Handling: Pemilik bisnis wajib menangani berbagai penyesuaian status melalui notification endpoint (webhook). Misalnya pada fitur QRIS DOKU yang mendukung nominal hingga Rp10 juta per transaksi, sistem backend harus siap menerima sinyal Callback Callback/Webhook saat pembayaran berhasil diproses oleh issuer.
Batasan: Walaupun merchant mengendalikan UI/UX secara penuh, kepatuhan standar keamanan seperti PCI DSS tetap berlaku. Dalam konteks DOKU Direct API, DOKU menangani infrastruktur keamanan dan enkripsi data sensitif pembayaran di sisi backend, sementara pemilik bisnis bertanggung jawab menjaga keamanan environment aplikasi mereka sendiri.

Karena itu, custom payment flow sebaiknya dipilih ketika kebutuhan bisnis memang membutuhkan fleksibilitas tambahan. Jika kebutuhan checkout relatif sederhana, solusi yang lebih terstandardisasi dapat mengurangi kompleksitas pengembangan dan maintenance. Jika alur checkout bisnis tergolong sederhana dan tidak membutuhkan kustomisasi mendalam, DOKU juga menyediakan solusi DOKU Checkout yang lebih cepat diimplementasikan tanpa perlu membangun UI dari nol.

Cara Kerja Custom Payment Flow API

Alur kerja Custom Payment Flow berpusat pada pemberian kontrol penuh kepada pemilik bisnis untuk merancang antarmuka (UI) dan alur pengguna di platform milik Anda. Transaksi diproses di backend menggunakan infrastruktur API DOKU tanpa mengalihkan (redirect) pelanggan ke halaman luar.

Seperti ini tahapan cara kerja custom payment flow DOKU Direct API:

Persiapan dan Konfigurasi Integrasi

Dalam proses integrasi, pemilik bisnis terlebih dahulu mengaktifkan metode pembayaran yang dibutuhkan dan menyiapkan kredensial API (API credentials). Selanjutnya, tim pengembang dapat memilih skema API yang sesuai dengan kebutuhan integrasi, baik SNAP sebagai standar nasional maupun Non-SNAP.

Untuk membantu mempercepat proses pengembangan, DOKU juga menyediakan Code Library dalam berbagai bahasa pemrograman yang dapat membantu proses integrasi sehingga tim dapat lebih fokus pada penerapan business logic sesuai kebutuhan bisnis.

Interaksi Pelanggan di Halaman Bisnis

Pelanggan memilih produk dan masuk ke halaman checkout yang dibangun dan dikelola sepenuhnya oleh merchant Kemudian pelanggan memilih salah satu dari 45+ metode pembayaran yang disediakan seperti Credit Card, Virtual Account, Direct Debit, atau QRIS. Semuanya langsung di dalam antarmuka aplikasi atau website Anda.

Pengiriman dan Pemrosesan Data Transaksi

Informasi pembayaran yang dikumpulkan di antarmuka milik merchant dikirimkan langsung ke backend DOKU melalui Direct API. Setelah itu, pemrosesan data transaksi dijalankan melalui infrastruktur DOKU yang aman dan memenuhi standar kepatuhan industri seperti PCI DSS.

Pembaruan Status dan Verifikasi

Untuk transaksi asynchronous seperti Virtual Account dan QRIS, DOKU dapat mengirimkan pembaruan status transaksi secara real-time ke sistem melalui webhook atau notification endpoint yang telah dikonfigurasi. Setelah pelanggan menyelesaikan pembayaran, sistem dapat menerima dan memproses notifikasi tersebut untuk memperbarui status transaksi.

Dengan begitu, pelanggan dapat melihat konfirmasi pembayaran seperti Paid, Pending, atau Failed langsung tanpa harus meninggalkan aplikasi atau website.

Manfaatkan Custom Payment Flow API untuk Bisnis Anda dengan DOKU Direct API

DOKU Direct API memungkinkan Anda menyesuaikan tampilan dan alur pembayaran sesuai kebutuhan bisnis, mengintegrasikan berbagai metode pembayaran, menjaga konsistensi brand, serta mengelola pengalaman checkout secara lebih fleksibel tanpa pengalihan ke halaman eksternal.

DOKU juga menyediakan opsi pengembangan lanjutan melalui DOKU Agentic Payments / MCP Server, di mana antarmuka pembayaran bahkan dapat disatukan ke dalam alur percakapan AI Agent, misalnya Customer Service AI. Pendekatan ini membuka peluang untuk menghadirkan pengalaman transaksi yang lebih praktis dan terintegrasi tanpa harus selalu berpindah aplikasi.

Cakupan Metode Pembayaran Yang Beragam

DOKU menyediakan lebih dari 45 metode pembayaran yang dapat disesuaikan dengan kebiasaan transaksi pelanggan tanpa perlu mengintegrasikan masing-masing kanal secara terpisah:

Kartu Kredit & Debit: Visa, Mastercard, JCB, dan American Express (AMEX).
Transfer Bank & Virtual Account: Mandiri, BCA, BRI, BNI, Permata, CIMB Niaga, Danamon, BSI, Maybank, Sinarmas, BTN, BNC, DOKU VA.
Dompet Digital & QRIS: QRIS, OVO, DANA, ShopeePay, LinkAja, DOKU e-Wallet
Debit Instan / Direct Debit: BRI Direct Debit, Mandiri Direct Debit, Allo Bank.
Paylater: Kredivo dan Akulaku.
Retail: Indomaret dan Alfa Group.

Integrasi Mudah dengan Pilihan Produk Lainnya

DOKU menawarkan beragam jalur integrasi yang dapat dipilih sesuai tingkat kesiapan teknologi dan infrastruktur platform Anda:

DOKU Checkout: Halaman checkout siap pakai untuk web dan aplikasi tanpa perlu membangun antarmuka dari nol. Dilengkapi fitur Custom Branding, Customer Email Notification, dan fitur lainnya.
DOKU Payment Link: Penerimaan pembayaran instan cukup dengan membagikan link tanpa membutuhkan situs web atau keahlian teknis.
DOKU Digital Catalog: Katalog produk online ringkas untuk menampilkan barang, stok, dan harga sekaligus memproses pembayaran langsung.

Perizinan Resmi dan Tepercaya

Keamanan data dan keandalan sistem menjadi prioritas utama DOKU dalam memproses seluruh aktivitas pembayaran. Dari sisi keamanan, payment provider perlu memenuhi standar yang dapat melindungi data dan proses transaksi. Salah satunya adalah sertifikasi PCI DSS, yang menetapkan persyaratan teknis dan operasional untuk melindungi data pembayaran kartu.

Selain itu, kepatuhan terhadap regulasi juga menjadi faktor penting, termasuk status sebagai Penyedia Jasa Pembayaran (PJP) yang berlisensi dan terdaftar secara resmi. Untuk perlindungan data, penerapan standar enkripsi industri membantu menjaga kerahasiaan data transaksi dan informasi pengguna selama proses pembayaran.

Ekosistem Lengkap untuk Pertumbuhan Jangka Panjang

Beroperasi sejak 2007 sebagai pionir payment gateway di Indonesia, DOKU telah berkembang menjadi penyedia ekosistem keuangan digital yang komprehensif.

Selain pengolahan pembayaran bisnis, DOKU menghadirkan infrastruktur B2B seperti Wallet as a Service dan dompet digital DOKU e-Wallet bagi pengguna. Seluruh layanan ini didukung pendampingan teknis dan customer service 24/7.

Untuk memulai skenario integrasi pembayaran yang paling sesuai bagi bisnis Anda, daftar melalui DOKU Registration atau hubungi tim Sales DOKU.