NICEPAY API
...
API Virtual Account SNAP
Registration - API Virtual Account SNAP
11 min
about registration api virtual account snap this api with the snap standards uses to request registration before executing payment using the virtual account payment method if you want to see a general explanation of virtual account payment methods, you can visit va payment guide docid\ ie9rxfmm gpysjakmrbvl for integration settings for fix open and nicepay inquiry virtual account features, you can visit the page virtual account advance api docid\ cadfseimkqmertral3p4u virtual account length number specification as explained on the virtual account (va) docid\ zf1ak3ppg5z1my1oevy7a , the length of the va number that can be created varies from each bank the length of the va can be determined according to business needs as long as the va number does not exceed the maximum length capacity that includes the nicepay and bank prefix the following is a table of requirements for va length number for some banks true false 166false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type note nicepay+bank prefix length is the number length requirement for nicepay and bank prefix numbers a case study if you as a merchant want to integrate mandiri bank va, then you are required to provide a space of 8 digits for the va prefix which consists of the nicepay and bank prefix later, the number after the prefix will be divided into 2 types according to the type of va you want to create fixed va you can customize the number after the va prefix number that nicepay refers to as the customer id or merfixacctid with a note that the number is no longer than the maximum 19 digits length for va numbers from bank mandiri normal va you cannot customize the number after the va prefix number because that number will be generated automatically and randomly by the system with a note that the number is no longer than the maximum 19 digits length for va numbers from bank mandiri the default length of va number is 16 digits unless there are a special schemes from banks, nicepay, and merchants although each bank may have different length of the va number, merchants are considered to be able to accommodate a va number lengths maximum of 30 digits in a row registration api virtual account snap please request the access token firsthand before doing the authentication through the request access token api snap docid 92feymrqs iebhxrfgxuq section 181,562,117 false false false unhandled content type false unhandled content type false unhandled content type false unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type request registration header parameter 144,77,85,105,253 false true false unhandled content type center true unhandled content type center true unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type center true unhandled content type center true unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type center true unhandled content type center true unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type center true unhandled content type center true unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type center true unhandled content type center true unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type center true unhandled content type center true unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type center true unhandled content type center true unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type center true unhandled content type center true unhandled content type false center unhandled content type false unhandled content type false unhandled content type request registration body parameter for partnerserviceid and virtualaccountno parameters can send with an empty value 177,75,76,105,181 false true false unhandled content type center false unhandled content type center false unhandled content type false unhandled content type false unhandled content type false unhandled content type center false unhandled content type center false unhandled content type false unhandled content type false unhandled content type false unhandled content type center false unhandled content type center false unhandled content type false unhandled content type false unhandled content type false unhandled content type center false unhandled content type center false unhandled content type false unhandled content type false unhandled content type false unhandled content type center false unhandled content type center false unhandled content type false unhandled content type false unhandled content type false unhandled content type center false unhandled content type center false unhandled content type false unhandled content type false unhandled content type false unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type center false unhandled content type center false unhandled content type false unhandled content type false unhandled content type false unhandled content type center false unhandled content type center false unhandled content type false unhandled content type false unhandled content type false unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type center false unhandled content type center false unhandled content type false unhandled content type false unhandled content type false unhandled content type center false unhandled content type center false unhandled content type false unhandled content type false unhandled content type false unhandled content type center false unhandled content type center false unhandled content type false unhandled content type false unhandled content type false unhandled content type center false unhandled content type center false unhandled content type false unhandled content type false unhandled content type false unhandled content type center false unhandled content type center false unhandled content type false unhandled content type false unhandled content type false unhandled content type center false unhandled content type center false unhandled content type false unhandled content type false unhandled content type false unhandled content type center false unhandled content type center false unhandled content type false unhandled content type false unhandled content type false unhandled content type center false unhandled content type center false unhandled content type false unhandled content type false unhandled content type false unhandled content type center false unhandled content type center false unhandled content type false unhandled content type false unhandled content type false unhandled content type center false unhandled content type center false unhandled content type false unhandled content type false unhandled content type response registration parameter false true 181,73,76,112,156false unhandled content type false unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false center unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false center unhandled content type false unhandled content type false unhandled content 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" } } }