Registration - API Virtual Account SNAP

tentang registration api virtual account snap api dengan standar snap ini digunakan untuk mengajukan pendaftaran sebelum melakukan pembayaran menggunakan metode pembayaran virtual account jika anda ingin melihat penjelasan umum metode pembayaran virtual account, anda dapat mengunjungi panduan bayar va docid\ bsnuzmhnlj9h0wrndsqyj untuk pengaturan integrasi fitur nicepay inquiry virtual account, anda dapat mengunjungi halaman api nicepay inquiry virtual account snap docid\ w zwlzxm p6fyqa3tqadd spesifikasi panjang nomor virtual account seperti yang sudah jelaskan pada halaman virtual account (va) docid 9tv3ro3 lj1f guz2gark , panjang dari nomor va yang dapat dibuat berbeda beda pada setiap bank panjang nomor va dapat ditentukan sendiri sesuai dengan kebutuhan bisnis selama nomor va tersebut tidak melebihi kapasitas panjang maksimum yang sudah termasuk dengan angka prefix bank dan prefix nicepay berikut adalah tabel persyaratan panjang nomor va untuk beberapa bank bank nicepay + bank prefix length max total va bca 8 23 bri 8 18 mandiri 8 19 maybank 8 16 bni 7 16 permata & syariah 7 16 cimb 7 19 danamon 7 16 hana 7 16 bjb 7 16 bnc 11 19 dki 9 16 catatan nicepay+bank prefix length merupakan persyaratan panjang angka untuk nomor prefix nicepay dan bank contoh kasus apabila anda sebagai merchant ingin melakukan integrasi dengan va bank mandiri, maka anda wajib untuk memberikan ruang sebesar 8 digit untuk prefix va yang terdiri dari prefix bank dan prefix nicepay selanjutnya, angka setelah prefix akan terbagi menjadi 2 tipe sesuai dengan tipe va yang ingin buat fixed va anda dapat melakukan kustomisasi angka setelah angka prefix va yang nicepay sebut sebagai customer id atau merfixacctid dengan catatan bahwa angka tersebut tidak lebih dari 19 digit panjang maksimal untuk nomor va dari bank mandiri normal va anda tidak dapat melakukan kustomisasi angka setelah angka prefix va karena angka tersebut akan melalui proses generate secara otomatis dan acak oleh sistem dengan catatan bahwa angka tersebut tidak lebih dari 19 digit panjang maksimal untuk nomor va dari bank mandiri panjang nomor va secara default adalah 16 digit kecuali ada skema khusus dari bank, nicepay, dan merchant meskipun setiap bank dapat memiliki panjang nomor va yang berbeda, merchant disarankan untuk dapat mengakomodasi panjang nomor va dalam satu deret maksimum 30 digit registration api virtual account snap silakan mengajukan akses token terlebih dahulu untuk melakukan autentikasi melalui bagian request access token api snap docid\ gcgqbiyxg1etcd0ji9chx service code 27 api endpoint /api/v1 0/transfer va/create va http method post description untuk mengajukan pendaftaran transaksi va content type application/json request registration header parameter parameter tipe ukuran kebutuhan deskripsi contoh content type string mandatory application / json authorization string mandatory bearer “ access token ” x timestamp string mandatory using iso 8601 as timestamp format transaction date time, in format yyyymmddthh\ mm\ ss+07 00 time must be in gmt+7 (jakarta time) 2022 03 21t10 11 40+07 00 x signature string mandatory signature will be generated by merchant snap api testing x partner id string 20 mandatory x partner id = client id x external id string 40 mandatory unique reference number ( 41807553358950093184 ) channel id string 20 mandatory unique channel merchant credential id number client id + "01" = channel id "ionpaytest" + "01" = "ionpaytest01" ionpaytest01 request registration body parameter untuk parameter partnerserviceid dan virtualaccountno dapat dikirim dengan nilai kosong parameter tipe ukuran kebutuhan deskripsi partnerserviceid string 20 mandatory partner service id / prefix customerno string 40 mandatory customer number (mandatory for fix type) virtualaccountno string 25 mandatory virtual account number virtualaccountname string 100 mandatory virtual account name trxid string 40 mandatory transaction id (reference number from merchant) totalamount object optional "totalamount" { } value string 12 mandatory transaction amount currency string 3 mandatory currency additionalinfo object optional "additionalinfo" { } bankcd string 4 mandatory bank code api snap docid 9woqy5 1hlf ucwshsdho goodsnm string 200 mandatory goods name dbprocessurl string mandatory notification url vacctvaliddt string 8 optional virtual account valid date vacctvalidtm string 6 optional virtual account valid time msid string 20 optional merchant seller id msfee string 7 optional merchant seller fee msfeetype string 2 optional merchant seller fee type mbfee string 7 optional merchant balance fee mbfeetype string 2 optional merchant balance fee type response registration parameter parameter tipe ukuran kebutuhan deskripsi responsecode string mandatory general response code and message api snap docid\ lkqjxsl5cmkdxyxxhyyss responsemessage string mandatory response message virtualaccountdata object mandatory "virtualaccountdata" { , "totalamount" { } } partnerserviceid string 20 mandatory partner service id / prefix (mandatory for fix type) customerno string 40 mandatory customer number (mandatory for fix type) virtualaccountno string 25 mandatory virtual account number virtualaccountname string 100 mandatory virtual account name trxid string 40 mandatory from create va request (reference number from merchant) totalamount object optional "totalamount" { } value string 12 mandatory transaction amount currency string 3 mandatory currency additionalinfo object optional "additionalinfo" { } bankcd string 4 mandatory bank code api snap docid 9woqy5 1hlf ucwshsdho txidva string 30 mandatory transaction id of virtual account goodsnm string 200 mandatory goods name vacctvaliddt string 8 mandatory virtual account valid date vacctvalidtm string 6 mandatory virtual account valid time msid string 20 optional merchant seller id msfee string 7 optional merchant seller fee msfeetype string 2 optional merchant seller fee type mbfee string 7 optional merchant balance fee mbfeetype string 2 optional merchant balance fee type sample parameter sample request //header section content type application/json authorization bearer eyj0exaioijkv1qilcjhbgcioijiuzi1nij9 eyjzdwiioijjt05qqvlurvnuiiwiaxnzijoitkldrvbbwsisim5hbwuioijcukloiiwizxhwijoimjaync0wmi0xmvqwodowotoznvoifq== aiyblx36dywffvw7dcoenxkoe2eawiyq84ztpuif3k8= x timestamp 2024 04 30t10 11 40+07 00 x signature ufbw7r8rhw79ioiv/hlv607m60qzaybv8uzmbsryb6/thlo/fhqvp4xryeluehoss9o+qs6vwtkb/ygtucc+tq== x partner id ionpaytest x external id txid202410142300021707638093 channel id ionpaytest { "partnerserviceid" "", "customerno" "", "virtualaccountno" "", "virtualaccountname" "john doe", "trxid" "2022020100000000000001", "totalamount" { "value" "10000 00", "currency" "idr" }, "additionalinfo" { "bankcd" "bmri", "goodsnm" "john doe", "dbprocessurl" "https //testing co id/", "vacctvaliddt" "", "vacctvalidtm" "", "msid" "", "msfee" "", "msfeetype" "", "mbfee" "", "mbfeetype" "" } } sample response { "responsecode" "2002700", "responsemessage" "successful", "virtualaccountdata" { "partnerserviceid" "", "customerno" "", "virtualaccountno" "70014000091733551548", "virtualaccountname" "jhon doe", "trxid" "2022020100000000000001", "totalamount" { "value" "10000 00", "currency" "idr" }, "additionalinfo" { "msid" "", "msfee" "", "msfeetype" "", "mbfee" "", "mbfeetype" "", "bankcd" "bmri", "txidva" "ionpaytest02202410141733551548", "goodsnm" "jhon doe", "vacctvaliddt" "20241016", "vacctvalidtm" "173355" } } }