Virtual Account SNAP
Create VA (SNAP) Create Virtual Account via SNAP transfer-va service.
HTTPMethod: POST${ROOT_URL}/v1.0/transfer-va/create-va
Parameter Required Type Length Remarks Content-Type M String - Fixed value application/json Authorization C String Dynamic The value of access_token; mandatory if using symmetric encryption X-TIMESTAMP M String 64 Jakarta time, format 2021-11-29T09:22:18+07:00 X-PARTNER-ID M String 36 Merchant ID X-EXTERNAL-ID M String 12 Request ID X-SIGNATURE M String Dynamic Signature strings X-IP-ADDRESS M String 15 Client IP (IPv4)
Parameter Required Type Length Remarks partnerServiceId M String 8 Derivative of X-PARTNER-ID, 8 digit left padding space customerNo M String 20 Unique number (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo virtualAccountNo M String 20 partnerServiceId (8 digit left padding space) + customerNo (up to 20 digits) virtualAccountName M String 255 Payer name virtualAccountEmail O String 255 Email virtualAccountPhone O String 30 Mobile phone, format 62xxxxxxxxxxxxx trxId M String 64 Merchant transaction ID + totalAmount M Object - Transaction amount - value M String 16,2 Amount with 2 decimals, e.g. 10000.00; static VA: 0.00 - currency M String 3 Currency, fixed value: IDR + billDetails O List - Array max 24 objects (Currently not used) - billCode O String 2 Bill code - billNo O String 18 Bill number - billName O String 20 Bill name - billShortName O String 18 Bill short name + billDescription O Object - Bill description - english O String 18 Description in English - indonesia O String 18 Description in Bahasa - billSubCompany O String 5 Partner product code + billAmount O Object - - - value M String 16,2 Amount with 2 decimals - currency M String 3 Currency, fixed value: IDR + additionalInfo O Object - - + freeTexts O List - Array max 25 objects - english O String 32 Displayed in channel - indonesia O String 32 Displayed in channel virtualAccountTrxType O String 1 Virtual Account type + feeAmount O Object - Transaction Amount (Currently not used) - value M String 16,2 Amount with 2 decimals - currency M String 3 Currency, fixed value: IDR expiredDate M String 25 Expiration ISO-8601, e.g. 2020-12-31T23:59:59-07:00 + additionalInfo M Object - Additional info - paymentType M String 32 PaymentType - storeId O String 32 Branch store ID
VA expires after one successful payment in validity period.
Payment type Encodings (code) BCA BCAVA, MultipleBCAVA, StaticBCAVA BNI BNIVA, MultipleBNIVA BRI BRIVA, MultipleBRIVA BSI BSIVA, MultipleBSIVA CIMB CIMBVA, MultipleCIMBVA Danamon DanamonVA, MultipleDanamonVA INA INAVA, MultipleINAVA Permata PermataVA, MultiplePermataVA Mandiri MandiriVA, MultipleMandiriVA, StaticMandiriVA Maybank MaybankVA, MultipleMaybankVA Muamalat MuamalatVA, MultipleMuamalatVA Sinarmas SinarmasVA, MultipleSinarmasVA BNC BNCVA, MultipleBNCVA, StaticBNCVA Nobu NobuVA, MultipleNobuVA, StaticNobuVA
POST .../v1.0/transfer-va/create-va HTTP/1.2 Content-type: application/json X-TIMESTAMP: 2020-12-21T14:56:11+07:00 X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5 X-ORIGIN: www.hostname.com X-PARTNER-ID: 010001 X-EXTERNAL-ID: 41807553358950093184162180797837 X-IP-ADDRESS: 172.24.281.24 { "partnerServiceId" : " 088899" , "customerNo" : "00000000000000000000" , "virtualAccountNo" : " 08889912345678901234567890" , "virtualAccountName" : "Jokul Doe" , "virtualAccountEmail" : "jokul@email.com" , "virtualAccountPhone" : "6281828384858" , "trxId" : "abcdefgh1234" , "totalAmount" : { "value" : "12345678.00", "currency" : "IDR" }, "billDetails" : [ { "billCode" : "01", "billNo" : "123456789012345678", "billName" : "Bill A for Jan", "billShortName" : "Bill A", "billDescription" : { "english" : "Maintenance", "indonesia" : "Pemeliharaan" }, "billSubCompany" : "00001", "billAmount" : { "value" : "12345678.00", "currency" : "IDR" }, "additionalInfo" : { } } ], "freeTexts" : [ { "english" : "Free text", "indonesia" : "Tulisan bebas" } ], "virtualAccountTrxType" : "1" , "feeAmount" : { "value" : "12345678.00", "currency" : "IDR" }, "expiredDate" : "2020-12-31T23:59:59-07:00" , "additionalInfo" : { "paymentType" : "XXXVA" } } Parameter Required Type Length Remarks Content-Type M String - Fixed value application/json X-TIMESTAMP M String 64 Jakarta time, format 2021-11-29T09:22:18+07:00
Parameter Required Type Length Remarks responseCode M String 7 HTTP status code + service code + case code responseMessage M String 150 Response message + virtualAccountData O Object - - - partnerServiceId M String 8 Derivative of X-PARTNER-ID, 8 digit left padding space - customerNo M String 20 virtualAccountNo fixed value 00000000000000000000 - virtualAccountNo M String 20 virtualAccountNo - virtualAccountName M String 255 Payer name - virtualAccountEmail O String 255 Email - virtualAccountPhone O String 30 Mobile phone, Format: 62xxxxxxxxxxxxx - trxId O String 32 Platform Order Number / Order Number + totalAmount O Object - Transaction Amount - value M String 16,2 Amount with 2 decimals - currency M String 3 Currency, fixed value: IDR + billDetails O List - Array max 24 Objects (Temporary Unavailable) - billCode O String 2 Bill code - billNo O String 18 Bill number - billName O String 20 Bill Name - billShortName O String 10 Bill short name + billDescription O Object - Bill description - english O String 18 Bill description in English - indonesia O String 18 Bill description in Bahasa - billSubCompany O String 5 Partner product code + billAmount O Object - Transaction Amount - value M String 16,2 Amount with 2 decimals - currency M String 3 Currency, fixed value: IDR + additionalInfo O Object - Additional Information + freeTexts O List - Array max 25 Objects - english O String 32 Displayed in Channel - indonesia O String 32 Displayed in Channel - virtualAccountTrxType O String 1 Virtual Account type + feeAmount O Object - Transaction Amount - value M String 16,2 Amount with 2 decimals - currency M String 3 Currency, fixed value: IDR - expiredDate M String 25 Expiration date for Virtual Account, ISO-8601 + additionalInfo O Object - Additional Information for custom use
Content-type: application/json X-TIMESTAMP: 2020-12-21T14:36:19+07:00 { "responseCode" : "2002700" , "responseMessage" : "Success" , "virtualAccountData" : { "partnerServiceId" : " 088899" , "customerNo" : "00000000000000000000" , "virtualAccountNo" : " 08889912345678901234567890" , "virtualAccountName" : "Jokul Doe" , "virtualAccountEmail" : "jokul@email.com" , "virtualAccountPhone" : "6281828384858" , "trxId" : "abcdefgh1234" , "totalAmount" : { "value" : "12345678.00", "currency" : "IDR" }, "billDetails" : [ { "billCode" : "01", "billNo" : "123456789012345678", "billName" : "Bill A for Jan", "billShortName" : "Bill A", "billDescription" : { "english" : "Maintenance", "indonesia" : "Pemeliharaan" }, "billSubCompany" : "00001", "billAmount" : { "value" : "12345678.00", "currency" : "IDR" }, "additionalInfo" : { } } ], "freeTexts" : [ { "english" : "Free text", "indonesia" : "Tulisan bebas" } ], "virtualAccountTrxType" : "1" , "feeAmount" : { "value" : "12345678.00", "currency" : "IDR" }, "expiredDate" : "2020-12-31T23:59:59-07:00" , "additionalInfo" : { "paymentType" : "XXXVA" } } }