Panduan Lengkap Non-SNAP API Payment Gateway

Table of Contents

Payment gateway website adalah sistem yang menghubungkan website bisnis dengan bank dan penyedia layanan pembayaran untuk memproses transaksi digital secara otomatis dan real-time. Penggunaannya membantu meningkatkan konversi penjualan, menyederhanakan operasional, menjaga keamanan transaksi, serta memudahkan pencatatan keuangan. Integrasinya dapat dilakukan melalui hosted payment page, API, atau plugin sesuai kebutuhan bisnis.

Anda juga dapat menyediakan berbagai metode pembayaran, seperti Virtual Account, e-wallet, QRIS, kartu kredit dan debit, paylater, serta pembayaran melalui gerai ritel. Untuk memilih penyedia yang tepat, Anda perlu mempertimbangkan kemudahan integrasi, kecepatan pencairan dana, tingkat keberhasilan transaksi, dan dukungan pelanggan. Sebelum digunakan, sistem harus melalui pengujian menyeluruh untuk memastikan keamanan, kenyamanan checkout, dan kelancaran proses pembayaran.

Simak pembahasan berikut untuk memahami cara kerja, keunggulan, serta hal-hal yang perlu diperhatikan sebelum menerapkannya pada bisnis.

Apa Itu Non-SNAP API dalam Payment Gateway?

Non-SNAP API adalah API payment gateway yang tidak menggunakan spesifikasi SNAP atau Standar Nasional Open API Pembayaran. Dalam integrasi ini, format request, response, authentication, endpoint, dan mekanisme lainnya mengikuti spesifikasi dari payment gateway yang digunakan.

Berbeda dari SNAP yang mengikuti metode autentikasi yang diseragamkan secara nasional oleh Bank Indonesia dan ASPI, API non-SNAP dirancang secara independen oleh masing-masing payment gateway.

Misalnya, sebuah merchant ingin menghubungkan website dengan payment gateway untuk membuat transaksi pembayaran. Sistem merchant akan mengirim request ke endpoint yang disediakan payment gateway. Setelah request diproses, payment gateway akan mengirimkan response yang dapat digunakan merchant untuk menentukan langkah berikutnya. Detail dari proses tersebut dapat berbeda tergantung pada API yang digunakan.

Mengapa Non-SNAP API Masih Digunakan?

Non-SNAP API masih digunakan karena menawarkan fleksibilitas integrasi sesuai kebutuhan bisnis dan karakteristik layanan pembayaran. Berikut beberapa faktor yang mendukung penggunaannya:

Fleksibilitas Fitur Transaksi: Non-SNAP API memungkinkan penyedia layanan mengembangkan fitur transaksi yang disesuaikan dengan kebutuhan merchant, termasuk kebutuhan pembayaran yang lebih spesifik.
Dukungan Metode Pembayaran Internasional: Non-SNAP API dapat mendukung integrasi dengan jaringan pembayaran global, seperti kartu kredit internasional dan saluran pembayaran lintas negara.

Kapan Merchant Menggunakan Non-SNAP API Payment Gateway?

Merchant dapat menggunakan non-SNAP API ketika payment service atau produk yang digunakan memang menyediakan API dengan spesifikasi non-SNAP.

Penggunaanya bisa menjadi satu-satunya pilihan pada kondisi berikut:

Membutuhkan Metode Pembayaran Global: Bisnis Anda menerima pembayaran kartu kredit dari pelanggan mancanegara atau menggunakan checkout lintas negara.
Fitur Pembayaran Berulang: Pengelolaan tagihan otomatis secara berkala untuk bisnis SaaS, membership, atau layanan berlangganan.
Integrasi dengan Plugin dan Platform Global: Menggunakan platform e-commerce global seperti Shopify, Magento, WooCommerce yang konektor resminya masih menggunakan jalur API privat dan bukan SNAP.
Ingin Menggunakan Sistem yang Sudah Ada: Terkadang merchant ingin mempertahankan integrasi yang sudah berjalan stabil. Sistem non-SNAP bisa digunakan sambil merchant dan penyedia payment gateway menyiapkan arsitektur baru untuk migrasi secara bertahap.

Bagaimana Cara Kerja Non-SNAP API Payment Gateway?

Secara umum, non-SNAP API payment gateway bekerja melalui pertukaran data antara sistem merchant dan payment gateway. Perbedaan dengan SNAP terletak pada spesifikasi yang digunakan.

Authentication

Sebelum mengirim request, sistem merchant biasanya perlu melakukan authentication menggunakan credential yang diberikan payment gateway. Mekanisme authentication dapat berbeda tergantung pada API yang digunakan.

Request dan Response

Request berisi data yang dibutuhkan payment gateway untuk memproses suatu aktivitas. Setelah request diproses, payment gateway akan memberikan response. Sistem merchant kemudian perlu membaca response tersebut dan menentukan tindakan berikutnya, misalnya menampilkan status pembayaran atau menyimpan informasi transaksi.

Callback dan Notification

Respons dari request pertama tidak selalu menjadi informasi terakhir mengenai transaksi. Beberapa transaksi dapat membutuhkan waktu untuk diproses sehingga statusnya dapat berubah setelah request awal. Payment gateway dapat menggunakan callback atau notification untuk mengirimkan perubahan status ke sistem merchant.

Transaction Status

Integrasi juga perlu menangani kondisi ketika request tidak dapat diproses. Tim developer perlu memahami error code dan status yang tersedia dalam dokumentasi API. Dengan begitu, sistem dapat menentukan kapan harus melakukan retry atau menandai transaksi sebagai gagal.

Non-SNAP API Payment Gateway vs SNAP API

Perbedaan antara keduanya terutama terletak pada standar yang digunakan untuk membangun dan menghubungkan API.

Apa yang Perlu Diperhatikan Saat Menggunakan Non-SNAP API?

Menggunakan non-SNAP API berarti merchant perlu memahami spesifikasi API yang diberikan provider secara lebih detail. Hal ini penting karena struktur dan mekanisme integrasi dapat berbeda dari API provider lainnya.

Migration & Compatibility

Sebelum menggunakan atau mengubah API, merchant perlu memastikan API dapat terhubung dengan sistem yang sudah ada. Hal ini termasuk checkout, order management, database, notification handler, dan sistem reconciliation. Setelah kompatibel, baru tim developer bisa melakukan migrasi.

Testing

Migrasi sebaiknya dilakukan melalui environment testing terlebih dahulu. Gunakan sandbox atau environment testing yang disediakan provider untuk menguji integrasi tanpa memproses transaksi production.

Merchant dapat menguji berbagai skenario transaksi sebelum API baru digunakan di production. Untuk perubahan besar, merchant juga perlu menyiapkan rollback plan agar sistem dapat dikembalikan ke kondisi sebelumnya jika ditemukan masalah setelah deployment.

Deprecation dan Versioning Strategy

API non-SNAP tidak selalu langsung dihentikan ketika standar SNAP mulai diterapkan. Biasanya, regulator dan payment gateway memberikan masa transisi agar merchant memiliki waktu untuk menyesuaikan sistem dan melakukan migrasi secara bertahap.

Deprecation: API atau fitur mulai ditinggalkan dan tidak lagi menjadi pilihan utama, tetapi belum tentu langsung dimatikan. Biasanya akan ada pemberitahuan dan masa transisi sebelum benar-benar dihentikan.
Versioning:pengelolaan beberapa versi API agar perubahan pada versi baru tidak langsung merusak atau memutus integrasi yang masih menggunakan versi lama.

Payment gateway juga dapat menerapkan versioning, yaitu menyediakan beberapa versi API secara bersamaan. Misalnya, integrasi lama tetap menggunakan Non-SNAP API versi tertentu, sementara integrasi baru menggunakan SNAP. Dengan cara ini, perubahan pada API baru tidak langsung membuat sistem merchant lama berhenti bekerja.

Checklist Go-Live Integrasi Non-SNAP

Sebelum meluncurkan integrasi Non-SNAP API ke lingkungan produksi, jalankan checklist teknis berikut:

API endpoint production sudah benar
Production credential sudah tersedia dan tersimpan dengan aman
Authentication dan signature sudah diuji
Request dan response sudah sesuai dokumentasi
Callback URL sudah dikonfigurasi
Transaction status sudah dipetakan
Error handling dan retry sudah diuji
Idempotency sudah diperhatikan
Monitoring dan logging sudah tersedia
Reconciliation process sudah disiapkan
Tim terkait memahami proses troubleshooting

FAQ tentang Non-SNAP API Payment Gateway

Berikut ini beberapa pertanyaan yang sering ditanyakan mengenai sistem non-SNAP API.

Apa itu non-SNAP API payment gateway?

Non-SNAP API payment gateway adalah integrasi API dengan payment gateway yang tidak menggunakan spesifikasi SNAP. Struktur dan mekanisme integrasinya mengikuti dokumentasi yang diberikan oleh payment service provider.

Apa perbedaan non-SNAP API dengan SNAP API?

Perbedaan utamanya adalah standar yang digunakan. SNAP API mengikuti spesifikasi SNAP, sedangkan non-SNAP API mengikuti spesifikasi dari masing-masing provider.

Apakah non-SNAP API aman digunakan?

Non-SNAP tidak berarti tidak aman. Keamanan bergantung pada mekanisme yang diterapkan provider dan implementasi merchant.

Apakah integrasi Non-SNAP kurang aman dibandingkan SNAP?

Tidak selalu.Non-SNAP API tetap menawarkan tingkat keamanan standar industri secara global.

Akselerasi Infrastruktur Pembayaran Bisnis Anda Bersama DOKU

‍

Setiap arsitektur bisnis karakter dan kebutuhan yang unik. Merchant bisa bebas memilih, ingin menggunakan Non-SNAP API atau SNAP API. DOKU hadir menyediakan ekosistem infrastruktur pembayaran terlengkap yang siap beradaptasi dengan teknologi perusahaan Anda.

Melalui portofolio solusi pembayaran yang fleksibel, DOKU mendampingi pertumbuhan transaksi bisnis Anda dari skala berkembang hingga enterprise. DOKU Direct API memberikan kendali penuh atas alur checkout dan custom user experience di dalam platform atau aplikasi bisnis.

Untuk integrasi yang lebih cepat dan praktis, DOKU Checkout yang mudah diintegrasikan dan cepat digunakan. Cocok untuk skala UMKM dan bisnis baru. Lalu ada DOKU Payment Link memungkinkan Anda membuat tautan pembayaran tanpa harus membangun website atau integrasi teknis yang kompleks. DOKU Payment Link juga dapat dikustomisasi melalui DOKU Dashboard, termasuk elemen seperti logo, tampilan halaman, dan urutan metode pembayaran.

DOKU sebagai Mitra Pembayaran untuk Mendukung Pertumbuhan Bisnis

DOKU tercatat sebagai PJP Kategori 1 dan memiliki cakupan layanan yang mencakup Payment Gateway. DOKU juga memiliki PCI DSS untuk keamanan data transaksi kartu serta standar keamanan informasi seperti ISO/IEC 27001 dan enkripsi AES-256.

Hal ini memberikan dasar bagi Anda untuk mempertimbangkan aspek keamanan dan kredibilitas ketika mengevaluasi DOKU sebagai payment gateway.

DOKU telah berpengalaman sejak 2007 dan berkembang dari pionir payment gateway menjadi perusahaan fintech pembayaran dengan berbagai solusi untuk kebutuhan Anda, termasuk Wallet as a Service, Embedded Wallet & Sub Account, serta Payouts. DOKU juga menyediakan dukungan after-sales yang proaktif, pendampingan berkelanjutan, dan customer service 24/7.

Jika bisnis Anda sedang mencari solusi payment gateway terbaik, daftar sebagai merchant dengan DOKU Registration atau hubungi tim Sales DOKU untuk mendapatkan solusi yang sesuai dengan kebutuhan bisnis.