--- title: Pengenalan SNAP slug: nicepay-api-pengenalan-snap description: Informasi tentang Pengenalan API SNAP yang disediakan oleh NICEPAY icon: {"faIcon":"fa-solid fa-book"} createdAt: 2026-10-27T10:37:39.049Z --- ## Mengenai SNAP **SNAP** (Standar Nasional Open API Pembayaran) adalah standar API pembayaran di Indonesia yang ditetapkan oleh Bank Indonesia dan dikelola bersama ASPI (Asosiasi Sistem Pembayaran Indonesia). Standar ini bertujuan agar penyedia *payment gateway* seperti NICEPAY dapat berkomunikasi dengan cara yang selaras. Berdasarkan [portal dev SNAP Bank Indonesia](https://apidevportal.bi.go.id/snap), SNAP mengatur tiga hal utama: - **Format dan URL API yang terstandar.** Path endpoint, nama field, dan struktur response mengikuti spesifikasi yang sama bagi seluruh penyedia. - **Standar keamanan.** Setiap request membutuhkan Access Token dan Signature digital. - **Response code yang terstruktur.** Setiap kode berisi informasi status, layanan, dan kasus. ## Komponen Sebuah Request SNAP API Setiap *request *API SNAP terdiri dari beberapa komponen berikut. | **Komponen** | **Fungsi** | | --------------------- | ----------------------------------------------------------------------------------------------------------- | | **Endpoint** | URL standar, misal `/nicepay/v1.0/access-token/b2b` untuk mengajukan token. | | **Access Token** | Otorisasi akses, berlaku 15 menit, dikirim sebagai Authorization: Bearer \{`accessToken`}. | | **Signature** | Tanda tangan digital pada header `X-SIGNATURE` untuk menjamin integritas dan non-repudiation. | | **Timestamp** | Header `X-TIMESTAMP` dengan format ISO-8601, ikut ditandatangani untuk mencegah request lama dipakai ulang. | | **Identitas partner** | `Client ID` dari NICEPAY, dikirim di header `X-CLIENT-KEY` | | **Body** | Data transaksi dalam format JSON dengan nama field sesuai standar SNAP. | | **Response code** | Kode 7 digit yang menjelaskan hasil request. | :::hint{type="info"} Rincian cara mendapatkan Access Token dan membuat Signature dapat dilihat pada halaman [Authentication - SNAP](docId\:wd-31XHbZbXhrs4YsXLD8). ::: ### Header yang Umum Dipakai | **Header** | **Dipakai pada** | **Keterangan** | | --------------- | -------------------- | ------------------------------------------------------------------------------------- | | `Content-Type` | Semua *request* | `application/json` | | `X-TIMESTAMP` | Semua *request* | Waktu request, `ISO-8601` dengan zona waktu GMT+7, contoh `2024-12-31T10:11:40+07:00` | | `X-CLIENT-KEY` | Request Access Token | `Client ID` dari NICEPAY | | `X-SIGNATURE` | Semua *request* | Signature digital yang dibuat Merchant | | `Authorization` | *Request* layanan | Bearer \{`accessToken`} | | `X-PARTNER-ID` | *Request* layanan | `Client ID` dari NICEPAY | | `X-EXTERNAL-ID` | *Request* layanan | Nomor referensi unik untuk setiap request yang dibuat | | `CHANNEL-ID` | *Request* layanan | `Client ID` ditambah `01` | ## Memahami Response Code SNAP Kode *response* SNAP terdiri dari **7 digit** dengan tiga bagian: | **Bagian** | **Jumlah digit** | **Arti** | | --------------------------- | ---------------- | ---------------------------------------------------------------------------------- | | Status HTTP | 3 | Contoh:
`200` Berhasil
`400` Request Salah
`401` Tidak Terotorisasi | | Kode layanan (service code) | 2 | Menunjukkan layanan yang dipanggil | | Kode kasus (case code) | 2 | Menjelaskan rincian hasil | Contoh: `2007300` - `200` adalah status HTTP sukses. - `73` adalah service code untuk Access Token. - `00` adalah kasus sukses. :::hint{type="info"} Silakan kunjungi halaman [Authentication - SNAP](docId\:wd-31XHbZbXhrs4YsXLD8) untuk melihat daftar *service code* dan halaman [General Response Code and Message - API SNAP](docId\:lKqJXSl5CMKdXYXxHYYSs) untuk melihat daftar lengkap *response code*. ::: ## Layanan NICEPAY yang Mendukung SNAP | **Layanan** | **API tersedia** | | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Virtual Account** | - [Registration - API Virtual Account SNAP](docId\:K4DeuHcQ_4pSto2beLqb7)
- [Check Status Transaction - API Virtual Account SNAP](docId\:xaW0SxwKv9j7b5zLbtVpR)
- [Balance Inquiry - API E-Wallet (Direct Debit) SNAP](docId\:sYZtLk4s_b0f2A08DHY4q)
- [Cancel - API Virtual Account SNAP](docId\:vN3l9wxp-CA7deDK7AtM8)
- [Notification - API Virtual Account SNAP](docId\:qHdxpJZEiKx0wrhE_atiN) | | **E-Wallet (Direct Debit)** | - [Account Binding - API E-Wallet (Direct Debit) SNAP](docId\:jsV9P_nt63W2A27oRCy5U)
- [Registration - API E-Wallet (Direct Debit) SNAP](docId:66iE5aVXXL4uqw6hqFPVV)
- [Check Status Transaction - API E-Wallet (Direct Debit) SNAP](docId\:vB63D8suaKPYP-4bIOWx9)
- [Refund Transaction - API E-Wallet (Direct Debit) SNAP](docId:8-hlezmJtlz45LRJnXcEc)
- [Notification Transaction - API E-Wallet (Direct Debit) SNAP](docId\:jHs6CAvEoehyUj3Ji47Hh) | | **QRIS** | - [Registration - API QRIS SNAP](docId\:n42BapM1t1eOiXNS-RA_d)
- [Check Status Transaction - API QRIS SNAP](docId:3aXWe6p6cyHX_ZuN-bvgQ)
- [Refund Transaction - API QRIS SNAP](docId\:U1UpkNC78XEyuHGD4CxPD)
- [Notification - API QRIS SNAP](docId\:YjUncBpvXHbdxdoT3Na5o) | | **Payout (Disbursement)** | - [Registration - API Payout (Disbursement) SNAP](docId\:SgtN0VBKPUWVOV62EVREB)
- [Approve Transaction - API Payout (Disbursement) SNAP](docId\:Q5UEc9-eqJxtmhVJtMbV7)
- [Reject Transaction - API Payout (Disbursement) SNAP](docId:926778w1tSetC6obRYhwX)
- [Cancel Transaction - API Payout (Disbursement) SNAP](docId:25Q_ooJlYAS8krNpg6bb3)
- [Inquiry - API Payout (Disbursement) SNAP](docId\:GkYB9CEm1x0EzRv_wCLre)
- [Balance Inquiry - API Payout (Disbursement) SNAP](docId\:e-wNhrOEkkZ1Hxiqz7S_5)
- [Notification - API Payout (Disbursement) SNAP](docId:23kjHEyImhQ75q-Pg1Y_R) | ## Perbedaan dengan API NICEPAY Non-SNAP Perbedaan antara API NICEPAY SNAP dengan Non-SNAP terdapat pada autentikasi dan format response. Setiap request SNAP menggunakan Access Token dan Signature digital serta response SNAP memiliki parameter dengan standar Bank Indonesia (seperti parameter `responseCode` milik standar Bank Indonesia dengan parameter `responseCd` milik NICEPAY). :::hint{type="info"} Silakan periksa halaman [Implementasi SNAP](docId:9NC4zMt_CIYOOoQ3RweUm) untuk panduan implementasi & migrasi yang lebih lengkap. :::