Apa itu SNAP?
SNAP adalah singkatan dalam bahasa Indonesia, yang berarti Standar Nasional API Pembayaran Terbuka, yang merupakan standar nasional untuk Pembayaran API Terbuka, disusun dan didefinisikan oleh Bank Indonesia (BI) atau Bank Sentral Indonesia.
Situs resmi untuk SNAP dapat ditemukan di sini https://apidevportal.aspi-indonesia.or.id/
SNAP mendefinisikan standar untuk API Pembayaran di Indonesia. Secara ringkas, SNAP mendefinisikan hal-hal berikut:
- Standar keamanan, i.e. assymetric signature
- URL API yang distandarisasi
- Header wajib dan opsional yang distandarisasi
- Struktur payload permintaan dan respons yang distandarisasi
- Format data menggunakan JSON dengan camelCase
SNAP API digunakan untuk penerimaan pembayaran. Untuk pengiriman dana, Anda bisa menggunakan Payouts API.
Cara Mengaktifkan SNAP APIs
Untuk memulai, Anda akan memerlukan:
- Membuat akun Xendit
- Email kami di help@xendit.co dan menyatakan:
- ID Bisnis Anda dalam email yang dapat diperoleh pada dasbor Anda.
- Infokan kepada kami bahwa Anda ingin mengaktivasikan ketiga hal ini pada dasbor Anda:
- Registrasi SNAP;
- Manajemen Digital Signature Key;
- Pengaturan Webhook URL SNAP API.
- Proses aktivasi akan memakan waktu sekitar 1 x 24 jam.
Setelah Anda menerima Client ID Anda dan RSA Keys telah diberikan, Anda dapat mulai melakukan panggilan API ke Xendit SNAP APIs.
Perbedaan Antara Xendit vs SNAP APIs
Sebagai pelanggan Xendit yang ada yang menggunakan Xendit APIs, Anda mungkin ingin melihat perbedaan antara integrasi Xendit saat ini Anda dan SNAP APIs untuk memahami perbedaan dan pekerjaan yang diperlukan untuk mengadopsi SNAP APIs.
Dalam bagian ini, kami akan menggunakan produk Virtual Account sebagai contoh untuk memvisualisasikan perbedaan antara Xendit Regional VA API dan Xendit SNAP VA API. Silakan merujuk ke tabel berikut untuk perbandingan:
| COMPONENT | XENDIT REGIONAL API | SNAP API |
|---|---|---|
| URL | https://api.xendit.co/callback_virtual_accounts | https://api.xendit.co/snap/v1.0/transfer-va/create-va |
| Security - Authentication |
Menggunakan Basic Auth + API Key melaluiAuthorizationheader |
Menggunakan Client ID in header through X-PARTNER-ID header |
| Security - Signature | Tidak wajib, dengan kapabilitas membuat signature wajib | Wajib |
| Mandatory Headers |
Content-Type, Authorization
|
Content-Type, X-PARTNER-ID, X-EXTERNAL-ID, etc (silahkan mengacu pada header diatas) |
| Data Format | Menggunakan snake_case, i.e. account_number |
Menggunakan camelCase, i.e. accountNumber
|
| Request | VA API sebagai contoh - external_id- name- etc |
VA API sebagai contoh - trxId- virtualAccountName- etc |
| Response |
Untuk response sukses akan memberikan body payload sukses. Untuk response gagal akan memberikan error_code dan message
|
Memberikan responseCode , responseMessage . Untuk response sukses akan memberikan body response tambahan |
Referensi API
Anda dapat mengunjungi referensi API lengkap kami di sini: https://xendit.stoplight.io/docs/snap-api/a3055895b60d5-xendit-snap-ap-is-beta