---

PakaiLink SNAP

---

PakaiLink adalah produk OpenAPI dari PT Pakai Donk Nusantara, perusahaan teknologi finansial yang berkomitmen untuk membangun ekosistem layanan keuangan yang inklusif dan dapat diakses oleh seluruh kalangan masyarakat di Indonesia. Dengan menghadirkan solusi inovatif, PakaiLink memungkinkan pengguna untuk bertransaksi dengan lebih mudah, aman, dan efisien. Saat ini, PakaiLink menyediakan berbagai metode bagi merchant untuk mengintegrasikan sistem mereka dengan layanan PakaiLink. Salah satu cara yang ditawarkan adalah melalui PakaiLink SNAP API, sebuah standar Open API yang dirancang untuk mempermudah proses pembayaran digital. SNAP (Standar Nasional Open API Pembayaran) adalah inisiatif dari Bank Indonesia yang bertujuan untuk menciptakan sistem pembayaran di Indonesia yang lebih terbuka dan terintegrasi, memungkinkan kolaborasi yang lebih luas di antara penyedia layanan keuangan.

 

Pembaruan Dokumentasi

Berikut langkah-langkah untuk menggunakan API SNAP PakaiLink:

1. Pilih layanan yang ingin Anda integrasikan, daftar lengkap API PakaiLink dapat dilihat di SNAP Services. Kemudian, dapatkan client ID, client secret, dan merchant_id Anda untuk melanjutkan langkah integrasi.
2. Pelajari cara membuat dan menghasilkan signature dengan membaca panduan SNAP Signature. Terdapat dua metode signature yang tersedia: Asymmetric dan Symmetric.

 

---

SNAP Signature

---

Asymmetric Signature

Asymmetric Signature digunakan untuk melakukan verifikasi permintaan Access Token. Proses pembuatan signature dilakukan menggunakan private key. Sistem PakaiLink mendukung format PKCS#8 untuk private key, sehingga merchant akan diminta untuk membuat signature menggunakan file pkcs8_rsa_private_key.pem. Signature yang dihasilkan kemudian akan diverifikasi menggunakan public key yang disimpan dalam file rsa_public_key.pem. PakaiLink menggunakan algoritma SHA256withRSA, dengan tipe format yang diterapkan adalah Base64.

Pembuatan Asymmetric Key

1. Gunakan perintah berikut untuk menghasilkan private key RSA:
   

   openssl genrsa -out rsa_private_key.pem 2048
   
   

2. Setelah private key dibuat, ekstrak public key dengan perintah ini:

   openssl rsa -in rsa_private_key.pem -out rsa_public_key.pem -pubout
   
   

3. Konversi private key ke format PKCS#8 untuk meningkatkan kompatibilitas:

   openssl pkcs8 -topk8 -in rsa_private_key.pem -out pkcs8_rsa_private_key.pem -nocrypt
   
   

Setelah merchant berhasil memperoleh public key, langkah selanjutnya adalah membagikan key tersebut ke PakaiLink untuk melanjutkan proses pembuatan signature.

 

Pembuatan Signature

1. Siapkan data yang diperlukan untuk menghasilkan signature digital.
   

   No	Data	Keterangan	Contoh
   1	X-CLIENT-KEY	Identifier unik untuk mitra, yang dikenal sebagai clientId, dihasilkan secara otomatis oleh PakaiLink untuk memastikan setiap mitra memiliki identitas yang unik dan ter verifikasi.	ac517edf8c7ca47b9b3a334dd8bacb59
   2	X-TIMESTAMP	Tanggal dan waktu transaksi harus mengikuti format YYYY-MM-DDTHH:mm:ss+07:00, dengan waktu yang disesuaikan dengan GMT+7 (Waktu Jakarta), untuk memastikan kesesuaian dengan zona waktu lokal.	2025-01-30T12:38:12+07:00

    

2. Gabungkan nilai X-CLIENT-KEY dan X-TIMESTAMP menggunakan tanda pipe (|) untuk membentuk string yang siap untuk proses sign. Berikut contoh formatnya:
   ac517edf8c7ca47b9b3a334dd8bacb59|2025-01-30T12:38:12+07:00

    

3. String signature dibuat dengan mengenkripsi string yang telah disusun menggunakan algoritma SHA-256 dengan enkripsi RSA-2048 menggunakan private key dalam format PKCS#8 atau PKCS#1, lalu encode hasil enkripsi tersebut ke dalam format Base64 untuk menghasilkan signature yang dapat digunakan dalam proses verifikasi.
   

   IzAqHsx6ygZV6sWW6ng9QtfHOsrNaxUo3brQz+1oZ26RJp6NGOTmPyipKvs2whoTURh9ZMx8ao6rUYRdsbN16rGuLqxbzD70IcWYIbitXbgVCRt5Dx0BogynF2pZBcS+BJNhdgRqlSJQXjI3YhuSzbmEE1O1wYycWDqSksP1VwGLIhj87Xl837GTqK8AT7dP/Bq4/pjGFfpl60BrKtkw58waHMY/S4leUbo+XWT92SzCtjjJmb9rwTDlSJbUPHjJCarQC+02+A7dnTedo0/ckSPrpqzOmRwlXPhAZF+E+Edj0TPXlvYkuLBc+Svag3PUMWy7+GAYRoupfC6mKydfgA==

    

4. Letakkan string signature hasil encode ke dalam header HTTP X-SIGNATURE, seperti contoh berikut:
   Format:
   

   X-SIGNATURE: <Base64_Encoded_Signature>

   Contoh:
   

   X-SIGNATURE: IzAqHsx6ygZV6sWW6ng9QtfHOsrNaxUo3brQz+1oZ26RJp6NGOTmPyipKvs2whoTURh9ZMx8ao6rUYRdsbN16rGuLqxbzD70IcWYIbitXbgVCRt5Dx0BogynF2pZBcS+BJNhdgRqlSJQXjI3YhuSzbmEE1O1wYycWDqSksP1VwGLIhj87Xl837GTqK8AT7dP/Bq4/pjGFfpl60BrKtkw58waHMY/S4leUbo+XWT92SzCtjjJmb9rwTDlSJbUPHjJCarQC+02+A7dnTedo0/ckSPrpqzOmRwlXPhAZF+E+Edj0TPXlvYkuLBc+Svag3PUMWy7+GAYRoupfC6mKydfgA==

Symmetric Signature

Symmetric Signature digunakan untuk melakukan verifikasi permintaan layanan SNAP Anda. Signature ini dihasilkan menggunakan client secret dengan algoritma SHA-512 HMAC, kemudian encode hasilnya dalam format Base64 untuk memastikan keamanan dan integritas data.

Pembuatan Signature

1. Siapkan data yang diperlukan untuk membuat signature.
   

   No	Data	Keterangan	Contoh
   1	HTTP METHOD	Metode yang digunakan pada setiap API, seperti GET, POST, PUT, PATCH, dan DELETE, menentukan jenis operasi yang akan dilakukan pada sumber daya di server.	POST
   2	RELATIVE PATH URL	URL yang merujuk pada alamat yang digunakan untuk mengakses dan berinteraksi dengan sumber daya tertentu di server	/snap/v1.0/transfer-va/create-va
   3	ACCESS TOKEN B2B	Access Token B2B dapat diperoleh melalui Authorization Token Request dengan mengirimkan permintaan ke server otorisasi.	eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJpc3MiOiJQ QUtBSUxJTksiLCJqdGkiOiIyNDc0NzdlNjk0ZGM3N2FhZD U5YzA4MjA1NzdmZmViNyIsImV4cCI6MTE3NDAyOTc2N zgsImFzIjoicGFydG5lciIsImlkIjoiUFRSMDAwMDAwMyJ9. XmUxHExWILJCHJG74Af8TPJljX2aOmUz4UwJXumxkqxW 9uDsIrSX_M_j0uRzPOmaBkk2_rQiHIo_OX_qxv45Mg
   4	HTTP BODY	Perkecil ukuran request body dengan menghapus karakter yang tidak diperlukan, kemudian hash body menggunakan SHA-256. Untuk informasi lebih lanjut, silakan lihat langkah 2 dan 3.	080fd80881349db059d87cc2a93af2ec9c00c74dac5e97fa ca0b544732c8de18
   5	X-TIMESTAMP	Tanggal dan waktu transaksi harus mengikuti format YYYY-MM-DDTHH:mm:ss+07:00, dengan waktu yang disesuaikan dengan GMT+7 (Waktu Jakarta), untuk memastikan kesesuaian dengan zona waktu lokal.	2025-01-30T12:38:12+07:00

2. Minify request body
   
   HTTP body before minify:
   {
   "partnerServiceId": "   12334",
   "customerNo" : "318574181222",
   "virtualAccountName" : "Setya Wardana",
   "trxId": "2MkdEnmf434udFGuk1hE9sFL49Myv2q4xTQP",
   "virtualAccountTrxType": "C",
   "totalAmount": {
       "value": "10000.00",
       "currency": "IDR"
   },
   "additionalInfo": {
       "callbackUrl": "http://partner-domain/callback",
       "bankCode": "008"
   }
}
   
   

   HTTP body after minify:

   {"partnerServiceId":"12334","customerNo":"318574181222","virtualAccountName":"SetyaWardana","trxId":"2MkdEnmf434udFGuk1hE9sFL49Myv2q4xTQP","virtualAccountTrxType":"C","totalAmount":{"value":"10000.00","currency":"IDR"},"additionalInfo":{"callbackUrl":"http://127.0.0.1:10007/callback/partner","bankCode":"008"}}
   
   

3. Lowercase(HexEncode(SHA-256(RequestBody))).
   Mengubah request body menjadi hash menggunakan SHA-256, kemudian konversi hasil hash tersebut ke dalam format Hexadecimal, dan terakhir mengubah seluruh hasilnya menjadi huruf kecil.

   080fd80881349db059d87cc2a93af2ec9c00c74dac5e97faca0b544732c8de18
   
   

4. Compose string untuk proses sign.
   Membuat sebuah string gabungan yang akan digunakan untuk menghasilkan signature digital. String ini biasanya terdiri dari beberapa elemen penting, yaitu sebagai berikut:
   <HTTP METHOD> + ":" + <RELATIVE PATH URL> + ":" + <ACCESS TOKEN B2B> + ":" + LowerCase(HexEncode(SHA-256(Minify(<HTTP BODY>)))) + ":" + <X-TIMESTAMP>
   Contoh:
   POST:/snap/v1.0/transfer-va/create-va:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJpc3MiOiJQQUtBSUxJTksiLCJqdGkiOiIyNDc0NzdlNjk0ZGM3N2FhZDU5YzA4MjA1NzdmZmViNyIsImV4cCI6MTE3NDAyOTc2NzgsImFzIjoicGFydG5lciIsImlkIjoiUFRSMDAwMDAwMyJ9.XmUxHExWILJCHJG74Af8TPJljX2aOmUz4UwJXumxkqxW9uDsIrSX_M_j0uRzPOmaBkk2_rQiHIo_OX_qxv45Mg:080fd80881349db059d87cc2a93af2ec9c00c74dac5e97faca0b544732c8de18:2025-01-30T12:38:12+07:00
   
   
5. Enkripsi String signature dari proses sebelumnya ke SHA-512 HMAC menggunakan Client Secret, kemudian ubah menjadi format Base64. Berikut contoh nilai yang dihasilkan:
   HFplT7auM0pHh9tOBl8gTpsQ4kDERjgi6SNAG+WEyA+ThpuquMknqV8EpLMS0lzi9DVOrseXjqdh+fl5XLN39A==
   
   
6. Tempatkan string signature pada header HTTP dengan nama "X-SIGNATURE" untuk memastikan keamanan dan validitas permintaan.
   X-SIGNATURE:
HFplT7auM0pHh9tOBl8gTpsQ4kDERjgi6SNAG+WEyA+ThpuquMknqV8EpLMS0lzi9DVOrseXjqdh+fl5XLN39A==
   
   

Validasi Callback Signature

1. Ambil signature dari header HTTP "X-SIGNATURE" yang dikirim oleh pengirim API untuk melakukan verifikasi keasliannya.
   X-Signature : gRDHLuQpscNyNV5JShXmaOkJHIJp8JrpYtLz4PzBAvuQZ0Yug5Ho0ze8pBlhP7r8tqepWAd68qyVc8aGLIkGhOofLKmWK38TJ2VVTkZC30W5SIxlVMCXHdEMdtvDtqtpOuyGK0owNlM3+de8ljzwisQ6aPX1SYrvA9QtNmGy1O+A3SP12r2GWhqcxhaL1T6g2X420L3alelJFTiBgeatM+1o/Fn0MLt9DxQa3c4ezxJpJAxVsJ3HdTP7PQcSajEoLTm3BIRajIhUP3dxgQKEXpDPXGwLFgEVJwW4EGJe39XuVJyiMxhUpB8kxinx76CNstDBw1Cawqm1iqAAHZH8Hg==
   
   
2. Susun string yang akan digunakan untuk melakukan verifikasi.
   <HTTP METHOD> + ":" + <PATH URL CALLBACK> + ":" + LowerCase(HexEncode(SHA-256(Minify(<HTTP BODY>)))) + ":" + <X-TIMESTAMP>
   Contoh:
   POST:http://localhost:10007/callback/partner:50b238af7511827d11bab19c61207aaf52511f369188f08cc8e821da1ba78a0b:2025-03-06T13:10:14+07:00
   
   
3. Verifikasi keaslian signature menggunakan enkripsi SHA-256 dengan RSA-2048. Bandingkan string tersebut dengan public key yang diberikan oleh pengirim API.
   
   
4. Jika verifikasi berhasil, Anda dapat melanjutkan proses request.

 

---

SNAP Services

---

Authorization Token Request

Layanan ini dirancang untuk menangani semua tahapan dalam proses pengambilan Authorization Token. Penjelasan lebih mendalam mengenai setiap langkah akan dibahas pada bagian berikutnya.

Spesifikasi API PakaiLink terdiri dari 1 endpoint utama, yaitu:

1. Access Token B2B
   API ini berfungsi untuk mendapatkan Authorization Token menggunakan client_id dan client_secret. Token yang diperoleh dapat digunakan pada header HTTP Authorization untuk autentikasi lebih lanjut.
   
   

Pembuatan dan Validasi Signature

Layanan ini menerapkan teknologi Asymmetric Signature.

Versi

---

Virtual Account

Layanan ini memungkinkan pengguna untuk melakukan pembayaran pada tagihan, invoice, atau pesanan tertentu. Layanan ini terdiri dari dua API. Penjelasan lebih rinci akan disampaikan pada bagian selanjutnya.

Spesifikasi API PakaiLink terdiri dari 2 endpoint utama, yaitu:

1. Create Virtual Account
   API ini berfungsi untuk membuat akun virtual (VA) dari PakaiLink yang terhubung ke Bank.  Endpoint ini dapat digunakan untuk membuat akun VA Statis (Open) dan VA Dinamis (Close).
2. Callback Payment Notif
   API ini digunakan untuk menginformasikan kepada partner ketika nomor VA telah dilakukan pembayaran.
   
   

Pembuatan dan Validasi Signature

Layanan ini menerapkan teknologi Symmetric Signature.

 

Versi

---

QRIS MPM (Aquirer)

Layanan ini digunakan untuk memungkinkan Partner menerima pembayaran QRIS MPM dengan integrasi API ke Pakailink sebagai pengakuisisi. Dalam layanan ini, terdapat 3 API. Untuk informasi lebih rinci akan dijelaskan di bagian selanjutnya.

Spesifikasi API PakaiLink terdiri dari 3 endpoint utama yaitu:

1. Generate QR MPM 
   API ini berfungsi untuk membuat QRIS oleh Partner melalui PakaiLink sebagai pengakuisisi.
2. Inquiry Transaction Status
   API ini digunakan untuk melakukan pengecekan status terbaru dari QR yang telah dibuat oleh partner.
3. Callback Payment Notif
   API ini digunakan untuk menginformasikan kepada partner ketika telah dilakukan pembayaran oleh pengguna akhir.
   
   

Pembuatan dan Validasi Signature

Layanan ini menerapkan teknologi Symmetric Signature.

 

Versi

---

Payment Retail

Layanan ini memungkinkan merchant untuk membuat sebuah tagihan yang pembayarannya dapat dilakukan melalui Modern Retail. Layanan ini terdiri dari 1 API. Penjelasan lebih lengkap akan dibahas di bagian selanjutnya.

Spesifikasi API PakaiLink terdiri dari 2 endpoint utama, yaitu:

1. Create Payment Retail
   API ini berfungsi untuk membuat kode pembayaran yang dapat dilakukan melalui Modern Retail seperti Indomaret dan Alfamart.
2. Callback Payment Retail
   API ini digunakan untuk menginformasikan kepada partner ketika telah dilakukan pembayaran oleh pengguna akhir.
   
   

Pembuatan dan Validasi Signature

Layanan ini menerapkan teknologi Symmetric Signature.

 

Versi

 

---

 

Versi

Kode dan Pesan Response

No	Response Code	Response Message	Remarks
1	2004700	Successful	Request telah berhasil diproses tanpa ada masalah.
2	4004701	Invalid Field Format	Panjang informasi tidak boleh melebihi 150 karakter.
3	4004702	Invalid Mandatory Field	Kolom atau field yang wajib diisi tidak lengkap atau formatnya tidak sesuai dengan yang diharapkan.
4	4014700	Unauthorized. [reason]	Kesalahan umum yang terjadi ketika pengguna atau sistem tidak memiliki izin untuk mengakses tindakan tertentu.
5	4014701	Invalid Token (B2B)	Token akses yang digunakan untuk otentikasi tidak sah atau sudah kedaluwarsa.
6	4034702	Exceeds Transaction Amount Limit	Jumlah uang terkecil atau terbesar yang dapat diproses dalam transaksi
7	4044708	Invalid Merchant	Merchant tidak ada atau dalam status abnormal
8	4094700	Conflict	X-EXTERNAL-ID tidak dapat digunakan lebih dari sekali dalam satu hari yang sama
9	4094701	Duplicate partnerReferenceNo	Nomor referensi mitra (partnerReferenceNo, trxId) yang digunakan sudah terdaftar atau digunakan sebelumnya dalam sistem
10	5004702	Backend system failure	Kesalahan yang terjadi di server saat mencoba memproses request

 

---

Inquiry Transaction Status

API Name	Inquiry Transaction Status
Function	API ini digunakan untuk menanyakan status pembayaran dan informasi yang dihasilkan qr dari platform merchant ke PakaiLink.
Service Code	53
Method	POST
URL	/snap/v1.0/qr/qr-mpm-status
Content Type	application/json
Related Service	QRIS MPM (Acquirer)

Request​

Header​

No	Name	Type	Length	Required	Condition	Remarks
1	Content-Type	String	Variable, 127 max	Wajib	-	Tipe konten, nilai selalu application/json
2	Authorization	String	Variable	Wajib	-	Berisikan B2B Bearer JWT Token, yang didapatkan dari Access Token B2B
3	X-TIMESTAMP	String	Fixed, 25 max	Wajib	-	Waktu transaksi, dalam format YYYY-MM-DDTHH:mm:ss+07:00. Zona waktu harus GMT+7 (Jakarta time)
4	X-PARTNER-ID	String	Variable, 36 max	Wajib	-	ID untuk mitra yang dihasilkan oleh PakaiLink. Unique ID untuk mitra
5	X-EXTERNAL-ID	String	Variable, 36 max	Wajib	-	Messaging reference ID unik yang dihasilkan oleh merchant. Numeric String. Nomor referensi harus unik di hari yang sama.
6	CHANNEL-ID	String	Variable, 5 max	Wajib	-	Identifikasi perangkat dimana API Service ini sedang diakses oleh pengguna. Daftar Channel ID dapat dilihat di sini.
7	X-SIGNATURE	String	Variable	Wajib	-	Signature harus dihasilkan dengan metode Symmetric Signature

 

Body​

No	Name	Type	Length	Required	Condition	Remarks
1	originalPartnerReferenceNo	String	Variable, 64 max	Optional	y: (originalReferenceNo = null)	Pengidentifikasi transaksi asli pada sistem mitra
2	originalReferenceNo	String	Variable, 64 max	Optional	y: (originalPartnerReferenceNo = null)	Pengidentifikasi transaksi asli pada sistem PakaiLink
3	serviceCode	String	Variable, 2 max	Wajib	-	Indikator jenis transaksi (kode layanan dari transaksi asli)

 

Contoh Request

POST /snap/v1.0/qr/qr-mpm-status
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJpc3MiOiJQQUtBSUxJTksiLCJqdGkiOiIyNDc0NzdlNjk0ZGM3N2FhZDU5YzA4MjA1NzdmZmViNyIsImV4cCI6MTE3NDAyOTc2NzgsImFzIjoicGFydG5lciIsImlkIjoiUFRSMDAwMDAwMyJ9.XmUxHExWILJCHJG74Af8TPJljX2aOmUz4UwJXumxkqxW9uDsIrSX_M_j0uRzPOmaBkk2_rQiHIo_OX_qxv45Mg
Content-Type: application/json
X-TIMESTAMP: 2025-01-30T12:38:12+07:00
X-PARTNER-ID: PTR0000003
X-EXTERNAL-ID: 1101167819
X-SIGNATURE: AaE7rxaiIFPQYryj+JxwOi826dQG4e8RbzagEBaAywS4ETa490Cy/3b1/Ljqput67EF+OgE0V1GDw2t/lxqEJw==
CHANNEL-ID: 95221
{
    "originalPartnerReferenceNo": "Mkbk7WbPyEB3PAYDI5ZlunhK02qOG8cPEZ4B",
    "serviceCode": "53",
    "merchantId": "1031964782"
}

Response​

Body​

No	Name	Type	Length	Required	Condition	Remarks
1	responseCode	String	Fixed, 7 max	Wajib	-	Lihat daftar kode response.
2	responseMessage	String	Variable, 150 max	Wajib	-	Lihat daftar kode response.
3	originalPartnerReferenceNo	String	Variable, 64 max	Optional	-	Pengidentifikasi transaksi asli pada sistem mitra
4	originalReferenceNo	String	Variable, 64 max	Wajib	jika berhasil, value akan terisi	Pengidentifikasi transaksi asli pada sistem PakaiLink
5	originalExternalId	String	Variable, 32 max	Optional	-	ID eksternal asli pada pesan header
6	serviceCode	String	Variable, 2 max	Wajib	-	Indikator jenis transaksi (kode layanan dari request transaksi asli)
7	transactionDate	String	Fixed, 25 max	Optional	-	Waktu transaksi: ISO8601, dalam format YYYY-MM-DDTHH:mm:ss+07:00. Zona waktu harus GMT+7 (waktu Jakarta)
8	latestTransactionStatus	String	Fixed, 2 max	Wajib	-	Kode kategori untuk status transaksi. Nilai-nilai tersebut meliputi: Berhasil, pesanan telah dibayar Dimulai, pesanan telah dibuat, tetapi belum dibayar Membayar, pesanan dalam proses pembayaran Dibatalkan, pesanan telah ditutup
9	transactionStatusDesc	String	Variable, 50 max	Optional	-	Deskripsi status transaksi
10	amount	Money	Variable	Wajib	-	Berisi dua sub-field. Nilai: Total Amount, termasuk pecahan Mata uang: Kode mata uang berdasarkan ISO
11	additionalInfo	JSON Object	Variable	Optional	-	Informasi tambahan
12	callback	String	Variable	Wajib	-	URL untuk dapat menerima notifikasi pembayaran setelah pembayaran dilakukan oleh pelanggan.
13	customerData	String	Variable, 50 max	Wajib	-	Nama pelanggan.
14	rrn	String	Variable, 12 max	Wajib	-	Nomor referensi dari transaksi QRIS
15	mdr	Money	Variable	Optional	-	Berisi dua sub-field. Nilai: Total Amount, termasuk pecahan Mata uang: Kode mata uang berdasarkan ISO
16	serviceFee	Money	Variable	Optional	-	Berisi dua sub-field. Nilai: Total Amount, termasuk pecahan Mata uang: Kode mata uang berdasarkan ISO
17	nominalPaid	Money	Variable	Optional	-	Berisi dua sub-field. Nilai: Total Amount, termasuk pecahan Mata uang: Kode mata uang berdasarkan ISO
18	totalPaid	Money	Variable	Optional	-	Berisi dua sub-field. Nilai: Total Amount, termasuk pecahan Mata uang: Kode mata uang berdasarkan ISO
19	totalReceive	Money	Variable	Optional	-	Berisi dua sub-field. Nilai: Total Amount, termasuk pecahan Mata uang: Kode mata uang berdasarkan ISO

Contoh Response

{
    "responseCode": "2005300",
    "responseMessage": "Successful",
    "originalPartnerReferenceNo": "Mkbk7WbPyEB3PAYDI5ZlunhK02qOG8cPEZ4B",
    "originalReferenceNo": "1741098450422",
    "originalExternalId": "1101167819",
    "serviceCode": "47",
    "transactionDate": "2025-03-04T21:27:31+07:00",
    "latestTransactionStatus": "00",
    "transactionStatusDesc": "Success",
    "paidTime": "2025-03-04T21:34:12+07:00",
    "amount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "additionalInfo": {
        "callback": "http://localhost:10007/callback/partner",
        "customerData": "Toko Kelontong",
        "rrn": "",
        "mdr": {
            "value": "0.00",
            "currency": "IDR"
        },
        "serviceFee": {
            "value": "3000.00",
            "currency": "IDR"
        },
        "nominalPaid": {
            "value": "10000.00",
            "currency": "IDR"
        },
        "totalPaid": {
            "value": "10000.00",
            "currency": "IDR"
        },
        "totalReceive": {
            "value": "7000.00",
            "currency": "IDR"
        }
    }
}

 

Kode dan Pesan Response

No	Response Code	Response Message	Remarks
1	2005300	Successful	Request telah berhasil diproses tanpa ada masalah.
2	4005301	Invalid Field Format	Panjang informasi tidak boleh melebihi 150 karakter.
3	4005302	Invalid Mandatory Field	Kolom atau field yang wajib diisi tidak lengkap atau formatnya tidak sesuai dengan yang diharapkan.
4	4015300	Unauthorized. [reason]	Kesalahan umum yang terjadi ketika pengguna atau sistem tidak memiliki izin untuk mengakses tindakan tertentu.
5	4015301	Invalid Token (B2B)	Token akses yang digunakan untuk otentikasi tidak sah atau sudah kedaluwarsa.
6	4045301	Transaction Not Found	Transaksi tidak ditemukan
7	4095300	Conflict	X-EXTERNAL-ID tidak dapat digunakan lebih dari sekali dalam satu hari yang sama
8	4095301	Duplicate partnerReferenceNo	Nomor referensi mitra (partnerReferenceNo, trxId) yang digunakan sudah terdaftar atau digunakan sebelumnya dalam sistem
9	5005302	Backend system failure	Kesalahan yang terjadi di server saat mencoba memproses request

 

---

Callback Payment Notif

API Name	Callback Payment Notif
Function	API ini digunakan untuk menginformasikan status pembayaran dan informasi dari PakaiLink ke platform merchant
Service Code	52
Method	POST
URL	URL yang ditambahkan saat mengakses endpoint generate QR Code sebelumnya.
Accept	application/json
Content Type	application/json
Related Service	QRIS MPM (Acquirer)

Request​

Header​

No	Name	Type	Length	Required	Condition	Remarks
1	Content-Type	String	Variable, 127 max	Mandatory	-	Tipe konten, nilai selalu application/json
2	X-TIMESTAMP	String	Fixed, 25 max	Mandatory	-	Waktu transaksi, dalam format YYYY-MM-DDTHH:mm:ss+07:00. Zona waktu harus GMT+7 (Jakarta time)
3	X-PARTNER-ID	String	Variable, 36 max	Mandatory	-	ID untuk mitra yang dihasilkan oleh PakaiLink. Unique ID untuk mitra
4	X-EXTERNAL-ID	String	Variable, 36 max	Mandatory	-	Messaging reference ID unik yang dihasilkan oleh merchant. Numeric String. Nomor referensi harus unik di hari yang sama.
5	CHANNEL-ID	String	Variable, 5 max	Mandatory	-	Identifikasi perangkat dimana API Service ini sedang diakses oleh pengguna. Daftar Channel ID dapat dilihat di sini.
6	X-SIGNATURE	String	Variable	Mandatory	-	Signature harus dihasilkan dengan metode Symmetric Signature

 

Body​

No	Name	Type	Length	Required	Condition	Remarks
1	originalPartnerReferenceNo	String	Variable, 64 max	Mandatory	-	Pengidentifikasi transaksi asli pada sistem mitra
2	originalReferenceNo	String	Variable, 64 max	Mandatory	-	Pengidentifikasi transaksi asli pada sistem PakaiLink
3	latestTransactionStatus	String	Fixed, 2 max	Mandatory	-	Status transaksi terakhir
4	transactionStatusDesc	String	Variable, 50 max	Optional	-	Deskripsi status transaksi
5	amount	Money	Variable	Mandatory	-	Berisi dua sub-field. Nilai: Total Amount, termasuk pecahan Mata uang: Kode mata uang berdasarkan ISO
6	additionalInfo	JSON Object	Variable	Optional	-	Informasi tambahan

 

Request Sample

POST /callback/partner
"Content-Type": "application/json",
"X-Timestamp": "2025-03-04T21:34:12+07:00",
"X-Signature": "V+0jAw/sXmW23c6j+5tb3bXTqrujxBd1fVKIHVtA84th/p6GAO9/PHBXCKvkVOCbCbv/w5uyht+oyjC8csQnZdKZm3yYbl+RJKEP1AvAcKX0de9BPGpMqiDSME9EKASBzoD6ieEkL77wXdnD9KoX2fd51f5COZQD2SUcrKoseKDNLrTMyPoI1dBMbxQjectdypO6seTzYOYsDnkzlpkFtYhPDD1h+Uk/jGqVjvKnegnvuU6f3baonrPU7lTsBCn50ZwbrBJYZnjlZDZVDgbUAwAsLzyCTcpy/RaFI56Hz6SzSAREOPMfgdF26qvCEVOnm2XGNv+jPjFUrToDOTO6ZQ==",
{
    "responseCode": "2004700",
    "responseMessage": "Successful",
    "originalPartnerReferenceNo": "Mkbk7WbPyEB3PAYDI5ZlunhK02qOG8cPEZ4B",
    "originalReferenceNo": "1741098450422",
    "originalExternalId": "1098449924",
    "serviceCode": "52",
    "latestTransactionStatus": "00",
    "transactionStatusDesc": "success",
    "createdTime": "2025-03-04T21:27:31+07:00",
    "finishedTime": "2025-03-04T21:34:12+07:00",
    "amount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "additionalInfo": {
        "callback": "http://localhost:10007/callback/partner",
        "customerData": "Hore Studio",
        "rrn": "20231011103236",
        "mdr": {
            "value": "0.00",
            "currency": "IDR"
        },
        "serviceFee": {
            "value": "3000.00",
            "currency": "IDR"
        },
        "nominalPaid": {
            "value": "10000.00",
            "currency": "IDR"
        },
        "totalPaid": {
            "value": "10000.00",
            "currency": "IDR"
        },
        "totalReceive": {
            "value": "7000.00",
            "currency": "IDR"
        }
    }
}

Response​

Body​

No	Name	Type	Length	Required	Condition	Remarks
1	responseCode	String	Fixed, 7 max	Mandatory	-	Lihat daftar kode response.
2	responseMessage	String	Variable, 150 max	Mandatory	-	Lihat daftar kode response.

Response Sample​

{
  "responseCode": "2005200",
  "responseMessage": "Successful"
}

 

Kode dan Pesan Response​

No	Response Code	Response Message	Remarks
1	2005200	Successful	Request telah berhasil diproses tanpa ada masalah.
2	5005202	Backend system failure	Kesalahan yang terjadi di server saat mencoba memproses request

 

---

Create Payment Retail

API Name	Create Payment Retail Code
Function	Layanan untuk menerima dan mengatur dana dari modern retail. FAQ :  Nominal minimum adalah IDR 15.000,00 Nominal maksimal adalah IDR 2.500.000,00 Settlement membutuhkan 2-4 hari untuk menerima dana ke saldo Anda.
Service Code	31
Method	POST
URL	/snap/v1.0/payment/modern-retail
Content Type	application/json
Related Service	Payment Retail

 

Request​

Header

No	Name	Type	Length	Required	Condition	Remarks
1	Content-Type	String	Variable, 127 max	Wajib	-	Tipe konten, nilai selalu application/json
2	Authorization	String	Variable	Wajib	-	Berisikan B2B Bearer JWT Token, yang didapatkan dari Access Token B2B
3	X-TIMESTAMP	String	Fixed, 25 max	Wajib	-	Waktu transaksi, dalam format YYYY-MM-DDTHH:mm:ss+07:00. Zona waktu harus GMT+7 (Jakarta time)
4	X-PARTNER-ID	String	Variable, 36 max	Wajib	-	ID untuk mitra yang dihasilkan oleh PakaiLink. Unique ID untuk mitra
5	X-EXTERNAL-ID	String	Variable, 36 max	Wajib	-	Messaging reference ID unik yang dihasilkan oleh merchant. Numeric String. Nomor referensi harus unik di hari yang sama.
6	CHANNEL-ID	String	Variable, 5 max	Wajib	-	Identifikasi perangkat dimana API Service ini sedang diakses oleh pengguna. Daftar Channel ID dapat dilihat di sini.
7	X-SIGNATURE	String	Variable	Wajib	-	Signature harus dihasilkan dengan metode Symmetric Signature

 

Body

No	Name	Type	Length	Required	Condition	Remarks
1	parnerReferenceNo	String	Variable, 127 max	Wajib	-	Nomor unik (hingga 20 digits).
2	customerId	String	Variable, 35 max	Wajib	-	Pengidentifikasi unik untuk pelanggan di dalam sistem
3	customerName	String	Variable, 100 max	Wajib	-	Pengidentifikasi unik untuk pelanggan yang disediakan oleh mitra.
4	customerPhone	String	Variable, 15 max	Optional	-	Nomor telepon pelanggan yang disediakan oleh mitra
5	customerEmail	String	Variable, 225 max	Optional	-	Alamat email pelanggan yang disediakan oleh mitra
6	expiredDate	String	Variable	Optional	y	Waktu kedaluwarsa dari VA dinamis yang dibuat (dalam format ISO). Jika variable ini tidak diisi, maka secara default akan diisi 24 jam oleh sistem.
7	totalAmount	money	Variable	Wajib	-	Berisi dua sub-field. Nilai: Total Amount, termasuk pecahan Mata uang: Kode mata uang berdasarkan ISO
8	additionalInfo	String	Variable	Wajib	-	Informasi tambahan
9	additionalInfo.productCode	String	Variable, 20 max	Wajib	-	Kode yang mewakili jenis metode pembayaran digital
10	additionalInfo.remark	String	text	Optional	-	Catatan tambahan atau komen dari mitra mengenai transaksi
11	additionalInfo.callbackUrl	String	text	Optional	-	URL untuk dapat menerima notifikasi pembayaran setelah pembayaran dilakukan oleh pelanggan

 

Contoh Request​

​Response​

Body

No	Name	Type	Length	Required	Condition	Remarks
1	responseCode	String	Fixed, 7 max	Wajib	-	Lihat daftar kode response.
2	responseMessage	String	Variable, 150 max	Wajib	-	Lihat daftar kode response.
3	paymentCodeRetail	String	Variable	Wajib	-	Berisikan data Retail Code

 

Contoh Response

{
   "responseCode": "2003100",
   "responseMessage": "Successful",
   "paymentData": {
       "partnerReferenceNo": "cD3b5yRiCtGmbFhaNCbhPde5W0jymwHzeEf6",
       "customerId": "31857119",
       "customerName": "Setya Wardana",
       "customerPhone": "085745512488",
       "customerEmail": "This email address is being protected from spambots. You need JavaScript enabled to view it.",
       "paymentCode": "1002000005536",
       "referenceNo": "RTI000002S",
       "totalAmount": {
           "value": "50000.00",
           "currency": "IDR"
       },
       "feeAmount": {
           "value": "3000.00",
           "currency": "IDR"
       },
       "additionalInfo": {
           "productCode": "ALFAMART",
           "remark": "Pembayaran",
           "callbackUrl": "http://localhost:10007/callback/partner"
       }
   }
}

Kode dan Pesan Response

No	Response Kode	Response Pesan	Keterangan
1	2003100	Successful	Request telah berhasil diproses tanpa ada masalah
2	4003101	Invalid Field Format	Panjang informasi tidak boleh melebihi 150 karakter
3	4003102	Invalid Wajib Field	Kolom atau field yang wajib diisi tidak lengkap atau formatnya tidak sesuai dengan yang diharapkan
4	4013100	Unauthorized. [reason]	Kesalahan umum yang terjadi ketika pengguna atau sistem tidak memiliki izin untuk mengakses tindakan tertentu
5	4013101	Invalid Token (B2B)	Token akses yang digunakan untuk otentikasi tidak sah atau sudah kedaluwarsa
6	4033101	Feature Not Allowed	Fitur yang diminta tidak diizinkan atau tidak tersedia
7	4033102	Exceeds Transaction Amount Limit	Jumlah uang terkecil atau terbesar yang dapat diproses dalam transaksi
8	4043103	Bank Not Supported By Switch	Bank yang digunakan tidak didukung oleh sistem
9	4093100	Conflict	X-EXTERNAL-ID tidak dapat digunakan lebih dari sekali dalam satu hari yang sama
10	4093101	Duplicate partnerReferenceNo	Nomor referensi mitra (partnerReferenceNo, trxId) yang digunakan sudah terdaftar atau digunakan sebelumnya dalam sistem
11	5003102	Backend system failure	Kesalahan yang terjadi di server saat mencoba memproses permintaan

 

---

Callback Payment Retail

API Name	Callback Payment Retail
Function	API yang digunakan untuk menginformasikan kepada mitra PakaiLink ketika kode payment telah dilakukan pembayaran.
Method	POST
Service Code	32
URL	URL yang ditambahkan saat mengakses endpoint create kode payment emoney sebelumnya.
Content Type	application/json
Related Service	Payment Retail

 

Request​

Header

No	Name	Type	Length	Required	Condition	Remarks
1	Content-Type	String	Variable, 127 max	Wajib	-	Tipe konten, nilai selalu application/json
3	X-TIMESTAMP	String	Fixed, 25 max	Wajib	-	Waktu transaksi, dalam format YYYY-MM-DDTHH:mm:ss+07:00. Zona waktu harus GMT+7 (Jakarta time)
7	X-SIGNATURE	String	Variable	Wajib	-	Signature harus dihasilkan dengan metode Symmetric Signature

 

Body

No	Name	Type	Length	Required	Condition	Remarks
1	transactionData	JSON Object	Variable	Wajib	-	Berisi informasi data callback transaksi emoney.

 

Contoh Request​

POST /callback/partner
"Content-Type": "application/json",
"X-Timestamp": "2025-03-04T12:33:28+07:00",
"X-Signature": "Au/HnhHlzXvfe3VK0zLYAEkEGiH2Zrc9lctjastNB/Ho/G4Z9N67e8zvH0j4WeK+2fTCsQg0LoWJqAlFtMBDqN7IBtffy4MzJ6uNN5P9TDp758f/xZlPrdT/c9MY7Y1IuirLHSQUxg3pO/ZDW0iKseordnGcxYYbhiApZxzd6Bw3z+uR+PlZA4CbZdORwCWLzcI1DL9VCXmjeH+NZCtf24CskGA+RhiFH/Vr95Vxux2oYSzDyy/xG5GASYujdIZ/dx9zC+lh9okLwhIEhF5bJ07bYu/IqKFPREEWZgiJ0gbyO5Mgh1RZh7EK6NNx7KuZSLZLW0aa3c62fNa6VhQFbA=="

{
  "transactionData": {
    "paymentFlagStatus": "00",
    "paymentFlagReason": {
      "english": "Success",
      "indonesia": "Sukses"
    },
    "partnerReferenceNo": "cD3b5yRiCtGmbFhaNCbhPde5W0jymwHzeEf6",
    "customerNo": "31857119",
    "customerName": "Setya Wardana",
    "paidAmount": {
      "value": "50000.00",
      "currency": "IDR"
    },
    "feeAmount": {
      "value": "3000.00",
      "currency": "IDR"
    },
    "creditBalance": {
      "value": "47000.00",
      "currency": "IDR"
    },

    "additionalInfo": {
      "callbackUrl": "http://localhost:10007/callback/partner",
      "balance": {
        "value": "997000.00",
        "currency": "IDR"
      }
    }
  }
}

 

​Response​

Body

No	Name	Type	Length	Required	Condition	Remarks
1	responseCode	String	Fixed, 7 max	Wajib	-	Lihat daftar kode response.
2	responseMessage	String	Variable, 150 max	Wajib	-	Lihat daftar kode response.

 

Contoh Response

{
 "responseCode": "2003200",
 "responseMessage": "Successful"
}

 

 

Kode dan Pesan Response

 

No	Response Kode	Response Pesan	Keterangan
1	2003200	Successful	Request telah berhasil diproses tanpa ada masalah

 

 

---

Inquiry Transfer ke bank

API Name	Transfer to Bank Account Inquiry
Function	API ini digunakan oleh merchant untuk melakukan pengecekan informasi rekening bank melalui PakaiLink Bisnis. Hasil yang didapatkan adalah nama pemilik nomor rekening. FAQ : Jumlah minimum adalah IDR 10.000,00 Jumlah maksimal adalah IDR 50.000.000,00
Service Code	42
Method	POST
URL	/snap/v1.0/emoney/bank-account-inquiry
Content Type	application/json
Related Service	Transfer ke Bank

 

Request​

Header

No	Name	Type	Length	Required	Condition	Remarks
1	Content-Type	String	Variable, 127 max	Wajib	-	Tipe konten, nilai selalu application/json
2	Authorization	String	Variable	Wajib	-	Berisi B2B Bearer JWT Token, yang telah Anda peroleh dari Access Token B2B
3	X-TIMESTAMP	String	Fixed, 25 max	Wajib	-	Tanggal dan waktu transaksi, dalam format. YYYY-MM-DDTHH:mm:ss+07:00. Waktu harus dalam format GMT+7 (Jakarta time)
4	X-PARTNER-ID	String	Variable, 36 max	Wajib	-	ID untuk mitra yang dihasilkan oleh PakaiLink. ID unik untuk setiap mitra.
5	X-EXTERNAL-ID	String	Variable, 36 max	Wajib	-	ID referensi pesan unik yang dihasilkan oleh merchant. String numerik. Nomor referensi yang harus unik dalam satu hari yang sama.
6	CHANNEL-ID	String	Variable, 5 max	Wajib	-	Identifikasi perangkat tempat layanan API diakses oleh pengguna akhir (pelanggan) saat ini. Daftar Channel ID dapat dilihat di sini.
7	X-SIGNATURE	String	Variable	Wajib	-	Tanda tangan perlu dihasilkan menggunakan metode Symmetric Signature

 

Body

No	Name	Type	Length	Required	Condition	Remarks
1	parnerReferenceNo	String	Variable, 225 max	Wajib	-	Nomor unik (hingga 36 digit).
2	beneficiaryAccountNumber	String	Variable, 25 max	Wajib	-	Nomor Rekening Penerima.
3	amount	money	Variable	Wajib	-	Jumlah uang yang terlibat dalam suatu transaksi
4	additionalInfo	String	Variable	Wajib	-	Informasi tambahan yang disertakan dalam suatu transaksi
5	additionalInfo.beneficiaryBankCode	String	Variable, 20 max	Wajib	-	Kode bank dimana proses inquiry akan dilakukan

 

Contoh Request​

POST /snap/v1.0/emoney/bank-account-inquiry
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJpc3MiOiJQQUtBSUxJTksiLCJqdGkiOiIyNDc0NzdlNjk0ZGM3N2FhZDU5YzA4MjA1NzdmZmViNyIsImV4cCI6MTE3NDAyOTc2NzgsImFzIjoicGFydG5lciIsImlkIjoiUFRSMDAwMDAwMyJ9.XmUxHExWILJCHJG74Af8TPJljX2aOmUz4UwJXumxkqxW9uDsIrSX_M_j0uRzPOmaBkk2_rQiHIo_OX_qxv45Mg
Content-Type: application/json
X-TIMESTAMP: 2025-01-30T12:38:12+07:00
X-PARTNER-ID: PTR0000003
X-EXTERNAL-ID: 1155348175
X-SIGNATURE: AaE7rxaiIFPQYryj+JxwOi826dQG4e8RbzagEBaAywS4ETa490Cy/3b1/Ljqput67EF+OgE0V1GDw2t/lxqEJw==
CHANNEL-ID: 95221
{
    "partnerReferenceNo": "ilFpX51e0CAttU2DW7dDWV7TCWqk1cE1wyJj",
    "beneficiaryAccountNumber" : "6750620416",
    "amount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "additionalInfo": {
        "beneficiaryBankCode": "014"
    }
}

​Response​

Body

No	Name	Type	Length	Required	Condition	Remarks
1	responseCode	String	Fixed, 7 max	Wajib	-	Lihat daftar kode response.
2	responseMessage	String	Variable, 150 max	Wajib	-	Lihat daftar kode response.
3	sessionId	String	Variable, 50 max	Wajib	-	Id untuk identifikasi transaksi yang sedang berlangsung
4.	partnerReferenceNo	String	Variable,  225 max	Wajib	-	Nomor referensi unik yang digunakan oleh mitra untuk mengidentifikasi transaksi
5	beneficiaryAccountNumber	String	Variable, 25 max	Wajib	-	Nomor rekening penerima yang digunakan untuk mengidentifikasi rekening tujuan
6	beneficiaryAccountName	String	Variable, 50 max	Wajib	-	Nama pemilik rekening penerima yang terdaftar pada bank
7	beneficiaryBankName	String	Variable, 100 max	Wajib	-	Nama bank tempat rekening penerima terdaftar
8	amount	money	Variable	Wajib	-	Jumlah uang yang terlibat dalam suatu transaksi
9	feeAmount	money	Variable	Wajib	-	Jumlah biaya layanan yang dikenakan dalam suatu transaksi
10	additionalInfo	JSON  Object	Variable	Wajib	-	Informasi tambahan yang disertakan dalam suatu transaksi
11	additionalInfo.balance	money	Variable	Wajib	-	Jumlah uang yang tersedia dalam suatu akun

 

Contoh Response

{
   "responseCode": "2004200",
   "responseMessage": "Successful",
   "sessionId": "INQ0000030",
   "partnerReferenceNo": "ilFpX51e0CAttU2DW7dDWV7TCWqk1cE1wyJj",
   "beneficiaryAccountNumber": "6750620416",
   "beneficiaryAccountName": "Henda Sujiadi",
   "beneficiaryBankName": "BANK BCA",
   "amount": {
       "value": "10000.00",
       "currency": "IDR"
   },
   "feeAmount": {
       "value": "3000.00",
       "currency": "IDR"
   },
   "additionalInfo": {
       "balance": {
           "value": "962000.00",
           "currency": "IDR"
       }
   }
}

Kode dan Pesan Response

No	Response Kode	Response Pesan	Keterangan
1	2004200	Successful	Request telah berhasil diproses tanpa ada masalah
2	4004201	Invalid Field Format	Panjang informasi tidak boleh melebihi 150 karakter
3	4004202	Invalid Wajib Field	Kolom atau field yang wajib diisi tidak lengkap atau formatnya tidak sesuai dengan yang diharapkan
4	4014200	Unauthorized. [reason]	Kesalahan umum yang terjadi ketika pengguna atau sistem tidak memiliki izin untuk mengakses tindakan tertentu
5	4014201	Invalid Token (B2B)	Token akses yang digunakan untuk otentikasi tidak sah atau sudah kedaluwarsa
6	4034201	Feature Not Allowed	Fitur yang diminta tidak diizinkan atau tidak tersedia
7	4034202	Exceeds Transaction Amount Limit	Jumlah uang terkecil atau terbesar yang dapat diproses dalam transaksi
8	4044203	Bank Not Supported By Switch	Bank yang digunakan tidak didukung oleh sistem
9	4094200	Conflict	X-EXTERNAL-ID tidak dapat digunakan lebih dari sekali dalam satu hari yang sama
10	4094201	Duplicate partnerReferenceNo	Nomor referensi mitra (partnerReferenceNo,trxId) yang digunakan sudah terdaftar atau digunakan sebelumnya dalam sistem
11	5004202	Backend system failure	Kesalahan yang terjadi di server saat mencoba memproses request

 

---

Transfer ke bank

API Name	Transfer to Bank Transfer
Function	API ini memungkinkan merchant untuk melakukan permintaan transfer dana ke bank melalui PakaiLink bisnis. Layanan ini berjalan secara real-time. Pastikan  Balance mencukupi untuk melakukan transfer. Faq :  Nominal minimum adalah IDR 10.000,00 Nominal maksimal adalah IDR 50.000.000,00
Service Code	43
Method	POST
URL	/snap/v1.0/emoney/transfer-bank
Content Type	application/json
Related Service	Transfer ke Bank

 

Request​

Header

No	Name	Type	Length	Required	Condition	Remarks
1	Content-Type	String	Variable, 127 max	Wajib	-	Tipe konten, nilai selalu application/json
2	Authorization	String	Variable	Wajib	-	Berisi B2B Bearer JWT Token, yang telah Anda peroleh dari Access Token B2B
3	X-TIMESTAMP	String	Fixed, 25 max	Wajib	-	Tanggal dan waktu transaksi, dalam format. YYYY-MM-DDTHH:mm:ss+07:00. Waktu harus dalam format GMT+7 (Jakarta time)
4	X-PARTNER-ID	String	Variable, 36 max	Wajib	-	ID untuk mitra yang dihasilkan oleh PakaiLink. ID unik untuk setiap mitra.
5	X-EXTERNAL-ID	String	Variable, 36 max	Wajib	-	ID referensi pesan unik yang dihasilkanoleh merchant. String numerik. Nomor referensi yang harus unik dalam satu hari yang sama.
6	CHANNEL-ID	String	Variable, 5 max	Wajib	-	Identifikasi perangkat tempat layanan API diakses oleh pengguna akhir (pelanggan) saat ini. Daftar Channel ID dapat dilihat di sini.
7	X-SIGNATURE	String	Variable	Wajib	-	Signature harus dihasilkan dengan metode Symmetric Signature

 

Body

No	Name	Type	Length	Required	Condition	Remarks
1	partnerReferenceNo	String	Variable, 225 max	Wajib	-	Nomor unik yang diisi oleh merchant atau partner.
2	beneficiaryAccountNumber	String	Variable, 25 max	Wajib	-	Nomor Rekening Penerima.
3	beneficiaryBankCode	String	Variable, 20 max	Wajib	-	Kode unik yang mengidentifikasi bank tujuan dalam sebuah transaksi
4	sessionId	String	Variable, 10 max	Wajib	-	Nomor referensi unik yang digunakan untuk mengidentifikasi permintaan inquiry dalam sistem
5	amount	money	Variable	Wajib	-	Jumlah dana yang terlibat dalam suatu transaksi
6	additionalInfo	String	Variable	Wajib	-	Informasi tambahan yang disertakan dalam suatu transaksi
7	additionalInfo.callbackUrl	String	Variable, text	Optional	-	URL yang digunakan oleh sistem untuk mengirimkan respons atau notifikasi otomatis setelah suatu transaksi atau proses selesai
8	additionalInfo.remark	String	Variable, text	Optional	-	Keterangan tambahan yang disertakan dalam suatu transaksi

 

Contoh Request​

POST /snap/v1.0/emoney/transfer-bank
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJpc3MiOiJQQUtBSUxJTksiLCJqdGkiOiIyNDc0NzdlNjk0ZGM3N2FhZDU5YzA4MjA1NzdmZmViNyIsImV4cCI6MTE3NDAyOTc2NzgsImFzIjoicGFydG5lciIsImlkIjoiUFRSMDAwMDAwMyJ9.XmUxHExWILJCHJG74Af8TPJljX2aOmUz4UwJXumxkqxW9uDsIrSX_M_j0uRzPOmaBkk2_rQiHIo_OX_qxv45Mg
Content-Type: application/json
X-TIMESTAMP: 2025-01-30T12:38:12+07:00
X-PARTNER-ID: PTR0000003
X-EXTERNAL-ID: 1155348175
X-SIGNATURE: AaE7rxaiIFPQYryj+JxwOi826dQG4e8RbzagEBaAywS4ETa490Cy/3b1/Ljqput67EF+OgE0V1GDw2t/lxqEJw==
CHANNEL-ID: 95221

{
    "partnerReferenceNo": "ilFpX51e0CAttU2DW7dDWV7TCWqk1cE1wyJj",
    "beneficiaryAccountNumber" : "6750620416",
    "beneficiaryBankCode" : "014",
    "sessionId": "INQ0000030",
    "amount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "additionalInfo": {
        "callbackUrl" : "http://localhost:10007/callback/partner",
        "remark": ""
    }
}

 

​Response​

Body

No	Name	Type	Length	Required	Condition	Remarks
1	responseCode	String	Fixed, 7 max	Wajib	-	Lihat daftar kode response.
2	responseMessage	String	Variable, 150 max	Wajib	-	Lihat daftar kode response.
3	referenceNo	String	Variable, 50 max	Wajib	-	Id transaksi yang dibuat oleh provider yang merepresentasikan transaksi yang sedang berlangsung
4.	partnerReferenceNo	String	Variable, 50 max	Wajib	-	Nomor referensi yang unik yang digunakan oleh mitra untuk mengidentifikasi transaksi
5	beneficiaryAccountNumber	String	Variable, 25 max	Wajib	-	Nomor rekening penerima yang digunakan untuk mengidentifikasi rekening tujuan
6	beneficiaryAccountName	String	Variable, 50 max	Wajib	-	Nama pemilik rekening penerima yang terdaftar pada bank
7	beneficiaryBankName	String	Variable, 50 max	Wajib	-	Nama bank tempat rekening penerima terdaftar
8	amount	money	Variable	Wajib	-	Jumlah uang yang terlibat dalam suatu transaksi
9	feeAmount	money	Variable	Wajib	-	Jumlah biaya yang dikenakan dalam  suatu transaksi
10	additionalInfo	JSON  Object	Variable	Wajib	-	Informasi tambahan yang disertakan  dalam suatu transaksi
11	additionalInfo.transactionStatus	String	Variable, 32 max	Wajib		Kode status transaksi: 00: Success 03: Pending 06: Failed
12	additionalInfo.transactionStatusDesc.english	String	Variable, 32 max	Wajib		Deskripsi status transaksi dalam bahasa Inggris: 00: Success 03: Pending 06: Failed
13	additionalInfo.transactionStatusDesc.indonesia	String	Variable, 32 max	Wajib		Deskripsi status transaksi dalam bahasa Indonesia: 00: Sukses 03: Tertunda 06: Gagal
14	additionalInfo.balance	money	Variable	Wajib	-	Jumlah uang yang tersedia dalam suatu akun

 

Contoh Response

{
  "responseCode": "2004300",
  "responseMessage": "Successful",
  "referenceNo": "BKO000002V",
  "partnerReferenceNo": "yKQC1WFSO9cmFGVa17sj6aqDXVUDqszRZBnC",
  "beneficiaryAccountNumber": "6750620416",
  "beneficiaryAccountName": "Henda Sujiadi",
  "beneficiaryBankName": "BANK BCA",
  "amount": {
    "value": "10000.00",
    "currency": "IDR"
  },
  "feeAmount": {
    "value": "3000.00",
    "currency": "IDR"
  },
  "additionalInfo": {
    "transactionStatus": "03",
    "transactionStatusDesc": {
      "english": "Pending",
      "indonesia": "Tertunda"
    },
    "balance": {
      "value": "949000.00",
      "currency": "IDR"
    }
  }
}

Kode dan Pesan Response

No	Response Kode	Response Pesan	Keterangan
1	2004300	Successful	Request telah berhasil diproses tanpa ada masalah
2	4004301	Invalid Field Format	Panjang informasi tidak boleh melebihi 150 karakter
3	4004302	Invalid Wajib Field	Kolom atau field yang wajib diisi tidak lengkap atau formatnya tidak sesuai dengan yang diharapkan
4	4014300	Unauthorized. [reason]	Kesalahan umum yang terjadi ketika pengguna atau sistem tidak memiliki izin untuk mengakses tindakan tertentu
5	4014301	Invalid Token (B2B)	Token akses yang digunakan untuk otentikasi tidak sah atau sudah kedaluwarsa
6	4034301	Feature Not Allowed	Fitur yang diminta tidak diizinkan atau tidak tersedia
7	4034302	Exceeds Transaction Amount Limit	Jumlah uang terkecil atau terbesar yang dapat diproses dalam transaksi
8	4044303	Bank Not Supported By Switch	Bank yang digunakan tidak didukung oleh sistem
9	4044311	invalid account	Akun tidak valid atau tidak dapat ditemukan dalam sistem
10	4094300	Conflict	X-EXTERNAL-ID tidak dapat digunakan lebih dari sekali dalam satu hari yang sama
11	4094301	Duplicate partnerReferenceNo	Nomor referensi mitra (partnerReferenceNo, trxId) yang digunakan sudah terdaftar atau digunakan sebelumnya dalam sistem
12	5004302	Backend system failure	Kesalahan yang terjadi di server saat mencoba memproses request