SNAP API Payment Gateway: Standar Integrasi, Cara Kerja, dan Implementasinya

Table of Contents

SNAP API (Standar Nasional Open API Pembayaran) adalah standar integrasi pembayaran yang ditetapkan untuk membantu sistem merchant dan penyedia layanan pembayaran bertukar data secara aman melalui API. Standar ini mencakup format komunikasi, autentikasi, mekanisme keamanan, notifikasi transaksi, dan pencegahan transaksi ganda.

DOKU Direct API mendukung integrasi berbasis SNAP untuk berbagai metode pembayaran, seperti Virtual Account, e-wallet, direct debit, kartu kredit, dan QRIS. Dibandingkan Non-SNAP, SNAP menyediakan acuan integrasi yang terstandarisasi sehingga membantu menyederhanakan pengembangan dan mendukung kepatuhan terhadap ketentuan Bank Indonesia.

Simak artikel ini untuk memahami fungsi SNAP API, tahapan integrasinya, serta checklist implementasi yang perlu diperhatikan sebelum sistem pembayaran diluncurkan ke tahap produksi (go-live).

Apa Itu SNAP API Payment Gateway?

SNAP API adalah standar Open API pembayaran. Standar ini dirancang agar berbagai perangkat teknologi yang berbeda bisa saling terhubung dan saling bertukar data secara aman. Standar ini mencakup ketentuan teknis, seperti hubungan antara penyedia layanan dan pihak yang menggunakan layanan pembayaran.

Dalam konteks payment gateway, SNAP dapat menjadi standar integrasi antara sistem pemilik bisnis dan payment service provider. Artinya, Anda tidak hanya mengirim data transaksi, tetapi mengikuti format, mekanisme autentikasi, dan pola komunikasi API yang telah ditentukan.

Posisi SNAP di Integrasi Payment Gateway

SNAP berperan sebagai standar dalam komunikasi API di ekosistem pembayaran. Sederhananya, SNAP membantu menentukan bagaimana sistem pemilik bisnis dan penyedia layanan pembayaran saling bertukar data. Standar ini mencakup beberapa aspek dalam integrasi, seperti format request dan response, autentikasi, serta mekanisme keamanan yang perlu diperhatikan.

Dalam praktiknya, SNAP bukanlah payment gateway yang memproses pembayaran. Payment gateway tetap berfungsi sebagai layanan yang menghubungkan merchant dengan berbagai metode pembayaran, sementara SNAP menjadi standar yang dapat digunakan dalam proses integrasi tersebut.

Kapan Merchant Menggunakan SNAP?

Merchant dapat menggunakan integrasi berbasis SNAP ketika layanan atau skema pembayaran yang digunakan termasuk dalam cakupan SNAP. Selain itu, penyedia layanan juga mendukung integrasi tersebut. Penggunaannya dapat membantu merchant membangun koneksi API berdasarkan standar yang sudah ditetapkan, sehingga tim teknis memiliki acuan yang lebih jelas.

Sebagai contoh, sebuah merchant ingin menghubungkan sistem checkout dengan payment gateway untuk memproses transaksi secara langsung melalui API. Sebelum mulai mengembangkan integrasi, tim engineering dapat melihat apakah layanan yang digunakan memiliki API berbasis SNAP dan apa saja persyaratan teknisnya. Dari sana, merchant dapat menentukan endpoint, authentication, request, response, hingga mekanisme notification yang perlu diimplementasikan.

Cara Kerja SNAP API

Proses transaksi menggunakan SNAP API dirancang dengan mengutamakan prinsip keamanan tingkat tinggi. Secara umum, alur kerja integrasi SNAP API mencakup tahapan berikut:

Authentication & Signature

Sebelum mengirim permintaan transaksi, sistem merchant perlu melakukan autentikasi menggunakan OAuth 2.0 dengan Bearer token. Untuk memastikan keamanan dan integritas permintaan, SNAP juga menggunakan asymmetric signature SHA256withRSA serta symmetric signature HMAC_SHA512 sesuai dengan kebutuhan transaksi.

Request & Response Standardization

Merchant mengirimkan payload data transaksi menggunakan format endpoint baku yang ditetapkan SNAP. Server payment gateway memvalidasi payload tersebut dan mengembalikan respon yang mencakup status transaksi serta detail pembayaran seperti nomor Virtual Account.

Callback / Notification

Setelah pelanggan menyelesaikan pembayaran, server payment gateway akan mengirimkan web hook atau callback notification secara otomatis ke URL merchant.

Error Code & Idempotency

SNAP mewajibkan penggunaan Header Idempotency Key untuk mencegah terjadinya pemrosesan transaksi ganda (double charge) jika terjadi penundaan jaringan atau retry mechanism.

Sandbox & Testing

Untuk memastikan proses integrasi berjalan lancar tanpa mengganggu operasional bisnis, merchant disarankan melakukan testing. Manfaatkan akun sandbox untuk mensimulasikan berbagai skenario transaksi, mulai dari pembayaran sukses dan juga yang gagal.

Metode Pembayaran DOKU Sudah Berstandar SNAP

DOKU Direct API menghadirkan solusi integrasi pembayaran berbasis skema SNAP (Standar Open API Pembayaran Nasional) yang memungkinkan bisnis menghubungkan sistem pembayaran secara langsung ke platform mereka atau self-hosted.

Melalui skema SNAP yang telah terstandarisasi oleh Bank Indonesia, DOKU menyediakan SDK atau Software Development Kit yang mempermudah proses kustomisasi. Hal ini memberikan fleksibilitas penuh bagi tim pengembang untuk mengustomisasi UI/UX dan payment journey sesuai brand guideline.

Konektivitas API berstandar SNAP pada DOKU Direct API mendukung beberapa metode pembayaran digital di Indonesia, dengan rincian sebagai berikut:

Virtual Account (VA): Mendukung pembayaran melalui nomor VA dari berbagai bank, seperti BCA, BRI, BNI, Mandiri, Permata, CIMB Niaga, Danamon, BSI, Maybank, Sinarmas, BTN, BNC.
E-Wallet: Mendukung dompet digital seperti OVO, DANA, ShopeePay, LinkAja, dan DOKU e-Wallet.
Direct Debit: Memungkinkan pembayaran dengan pendebetan rekening melalui layanan yang didukung, BRI Direct Debit, Mandiri Direct Debit, Allo Bank, OCTO Cash.
Kartu Kredit Indonesia: Mendukung pembayaran menggunakan kartu kredit seperti Visa, Mastercard, JCB, American Express (AMEX)Visa, Mastercard, JCB, American Express (AMEX).
QRIS: Memungkinkan pelanggan melakukan pembayaran dengan memindai kode QR melalui aplikasi perbankan atau dompet digital yang mendukung QRIS.

Sementara itu, metode pembayaran melalui gerai retail (convenience store), seperti Indomaret dan jaringan Alfa Group, serta PayLater seperti Kredivo dan Akulaku, tersedia melalui jalur integrasi Non-SNAP.

SNAP vs Non-SNAP: Yang Mana yang Dipilih Merchant?

Banyak merchant bertanya-tanya mengenai perbedaan mendasar antara API konvensional atau non-SNAP dengan SNAP API. Berikut perbedaannya

Keamanan: API Non-SNAP umumnya mengandalkan Secret Key sederhana atau Basic Auth. Sementara itu, SNAP API mewajibkan enkripsi berbasis standar industri terkini (OAuth 2.0 Asymmetric Signature dengan SHA256).
Kecepatan Integrasi: Mengintegrasikan API Non-SNAP dari tiga bank yang berbeda memerlukan tiga struktur coding yang berbeda pula. Dengan SNAP API, struktur kode untuk pembuatan Virtual Account atau QRIS tetap sama meskipun penyedia layanannya berbeda.
Kepatuhan Regulasi: Menggunakan SNAP API memastikan bisnis Anda mematuhi regulasi Bank Indonesia, yang secara langsung meningkatkan kredibilitas dan tingkat kepercayaan konsumen serta mitra perbankan.

Checklist Implementasi SNAP API Payment Gateway hingga Go-Live

Sebelum meluncurkan integrasi ke production, merchant dapat menggunakan checklist berikut:

Memahami kebutuhan payment flow dan metode pembayaran yang akan digunakan.
Menentukan endpoint dan API yang dibutuhkan.
Menyiapkan authentication dan credential.
Mengimplementasikan signature sesuai spesifikasi.
Menentukan endpoint untuk callback atau notification.
Menyiapkan logic untuk status transaksi.
Memetakan error code dan error handling.
Menerapkan idempotency untuk request yang membutuhkan retry.
Melakukan testing di sandbox.
Menguji transaksi yang berhasil dan juga yang gagal.
Menguji callback serta perubahan status transaksi.
Melakukan security review.
Melakukan final validation sebelum production.

Bagi merchant, checklist tersebut dapat membantu memastikan bahwa implementasi siap di segala kondisi.

FAQ

Pertanyaan seputar SNAP dalam sistem pembayaran API.

Apa itu SNAP API payment gateway?

SNAP API payment gateway adalah implementasi integrasi payment gateway yang menggunakan standar SNAP untuk komunikasi API dalam ekosistem pembayaran.

Apakah SNAP API sama dengan payment gateway?

Tidak. SNAP merupakan standar Open API pembayaran, sedangkan payment gateway adalah layanan yang membantu merchant menerima dan memproses pembayaran.

Apa yang perlu dipersiapkan untuk integrasi SNAP API?

Merchant perlu mempersiapkan sistem untuk authentication, signature, request dan response, callback atau notification, error handling, idempotency serta sandbox testing sesuai dokumentasi payment provider yang digunakan.

Apakah merchant harus menggunakan SNAP?

Kebutuhan penggunaan SNAP bergantung pada jenis layanan dan model bisnis. Merchant sebaiknya memeriksa ketentuan Bank Indonesia serta dokumentasi payment provider untuk menentukan kebutuhan integrasinya.

Integrasikan Pembayaran Berstandar SNAP dengan DOKU Direct API

Dukung kebutuhan integrasi pembayaran bisnis Anda dengan DOKU Direct API, solusi yang memungkinkan website atau aplikasi terhubung langsung dengan infrastruktur pembayaran DOKU melalui API berstandar SNAP maupun Non-SNAP. Dengan fleksibilitas integrasi ini, bisnis dapat menyesuaikan tampilan dan alur pembayaran (payment flow) sesuai kebutuhan serta identitas brand.

DOKU Direct API mendukung 45+ metode pembayaran digital, termasuk Virtual Account, e-wallet, Direct Debit, kartu kredit Indonesia, dan QRIS melalui skema SNAP sesuai cakupan layanan yang tersedia. Tim pengembang juga dapat memanfaatkan dokumentasi teknis serta SDK yang disediakan untuk membantu proses integrasi dan kustomisasi pengalaman checkout..

Dengan integrasi yang praktis, toko online Anda dapat menghadirkan sistem pembayaran berstandar Penyelenggara Jasa Pembayaran (PJP) Kategori 1 dari Bank Indonesia. Dukungan beragam saluran pembayaran yang aman di halaman checkout membantu meningkatkan kepercayaan pelanggan dan mendorong mereka menyelesaikan transaksi.

Solusi Integrasi Fleksibel dari DOKU

DOKU menawarkan ragam opsi integrasi pembayaran seperti DOKU Checkout, DOKU Direct API, DOKU Plugin, DOKU Payment Link, dan DOKU Digital Catalog yang siap menyesuaikan tingkat kesiapan teknologi bisnis Anda.

Gunakan DOKU Checkout untuk halaman pembayaran serba praktis, atau manfaatkan DOKU Direct API untuk fleksibilitas dan kontrol penuh atas pengalaman bertransaksi pelanggan. Bila belum memiliki website, Anda bisa mengandalkan DOKU Payment Link yang dapat dipersonalisasi via DOKU Dashboard, atau memajang produk siap jual melalui DOKU Digital Catalog. Beragamnya opsi ini memastikan Anda selalu memiliki solusi pembayaran yang pas di setiap fase pertumbuhan bisnis.

Untuk mendukung penggunaan solusi pembayaran dalam jangka panjang, DOKU juga menyediakan after-sales support yang proaktif, pendampingan berkelanjutan, dan customer service 24/7.

Daftar sebagai merchant melalui DOKU Registration atau hubungi tim Sales DOKU untuk mendapatkan solusi yang sesuai dengan kebutuhan bisnis Anda.