Virtual Account SNAP
Update VA (SNAP)
Update Virtual Account via SNAP transfer-va service.
HTTPMethod: POST
URL: ${ROOT_URL}/v1.0/transfer-va/update-va
Service Code: 32
Version: 1.0
ServiceGroup: transfer-va
ProductType: update-va
| Parameter | Required | Type | Length | Remarks |
|---|
| Content-Type | M | String | - | Fixed value application/json |
| Authorization | C | String | Dynamic | 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) |
| CHANNEL-ID | M | String | 5 | Fixed value 95221 |
| Parameter | Required | Type | Length | Remarks |
|---|
| partnerServiceId | String | M | 8 | Derivative of X-PARTNER-ID, similar to company code, 8 digit left padding space. partnerServiceId + customerNo or virtualAccountNo |
| customerNo | String | M | 20 | Unique number (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo |
| virtualAccountNo | String | M | 28 | partnerServiceId (8 digit left padding space) + customerNo (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo |
| virtualAccountName | String | M | 255 | Payer name |
| virtualAccountEmail | String | O | 255 | Email |
| virtualAccountPhone | String | O | 30 | Mobile phone, Format: 62xxxxxxxxxxxxx |
| trxId | String | O | 12 | Partner system transaction ID |
| virtualAccountTrxType | String | O | 1 | Virtual Account Type |
| +additionalInfo | Object | O | unlimited | From Inquiry Response |
| 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 | String | M | 7 | HTTP status code + service code + case code |
| responseMessage | String | M | 150 | Response description |
| + virtualAccountData | Object | M | | |
| - partnerServiceId | String | M | 8 | Derivative of X-PARTNER-ID, similar to company code, 8 digit left padding space |
| - customerNo | String | M | 20 | Unique number (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo |
| - virtualAccountNo | String | M | 28 | partnerServiceId (8 digit left padding space) + customerNo (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo |
| - trxId | String | O | 64 | Partner system transaction ID |
| + additionalInfo | Object | O | unlimited | From Inquiry Response |
POST /api/v1.0/transfer-va/update-va HTTP/1.1
Content-Type: application/json;charset=utf-8
X-TIMESTAMP: 2026-02-09T23:44:09.357+07:00
X-SIGNATURE: Cy3y********************jQ==
X-PARTNER-ID: 010001
X-EXTERNAL-ID: 20260210XXXXXXXXX
X-IP-ADDRESS: XXX.XXX.XXX.XXX
CHANNEL-ID: 95221
{
"partnerServiceId": " 010001",
"customerNo": "34534534",
"virtualAccountNo": "856701XXXXXXXX",
"virtualAccountName": "Jokul Doe",
"virtualAccountEmail": "jokul@email.com",
"virtualAccountPhone": "6281828384858",
"trxId": "PYL20260210XXXXXXXXX",
"totalAmount": {
"value": "15000.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": "15000.00",
"currency": "IDR"
},
"additionalInfo": {}
}
],
"freeTexts": [
{
"english": "Free text",
"indonesia": "Tulisan bebas"
}
],
"virtualAccountTrxType": "1",
"feeAmount": {
"value": "0.00",
"currency": "IDR"
},
"expiredDate": "2026-03-29T23:59:59-07:00",
"additionalInfo": {
"deviceId": "12345679237",
"channel": "mobilephone",
"paymentType": "MandiriVA"
}
}
HTTP/1.1 200 OK
Content-Type: application/json
{
"responseCode":"2002800",
"responseMessage":"Successful",
"virtualAccountData":
{
"partnerServiceId":" 010001",
"customerNo":"34534534",
"virtualAccountNo":"856701XXXXXXXX",
"virtualAccountName":"Jokul Doe",
"virtualAccountEmail":"jokul@email.com",
"virtualAccountPhone":"6281828384858",
"trxId":"PYL20260210XXXXXXXXX",
"totalAmount":
{
"value":"15000.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":"15000.00",
"currency":"IDR"
},
"additionalInfo":{}
}
],
"virtualAccountTrxType":"1",
"feeAmount":
{
"value":"0.00",
"currency":"IDR"
},
"expiredDate":"2026-03-29T23:59:59-07:00",
"additionalInfo":
{
"deviceId":"12345679237",
"channel":"mobilephone",
"paymentType":"MandiriVA"
}
}
}