Path/ordersnap/api/v1.0/transfer-va/create-va
HTTP MethodPOST
Versionv1.0
Service Code27

Request Header

Field NameField TypeMandatoryField Description
Content-typeStringMMedia type of the resource, i.e. application/json
X-TIMESTAMPStringMClient’s current local time in ISO-8601 format
X-SIGNATUREStringMCreated using symmetric signature HMAC_SHA512 algorithm. Read here
AuthorizationStringMRepresents access_token of a request; string starts with keyword “Bearer ” followed by access_token. Can get this token from Access Token B2B response. Read here
X-PARTNER-IDStringMUnique identifier for caller (client_id)
X-EXTERNAL-IDStringMMerchant’s unique ID per transaction request
CHANNEL-IDStringMPJP’s channel id.

Example Header

Field NameValue
Content-typeapplication/json
X-TIMESTAMP2024-03-19T14:30:00+07:00
X-SIGNATUREda1fa417c72d6b91c257e01e54fac824
AuthorizationBearer gp9HjjEj813Y9JGoqwOeOPWbnt4CupvIJbU1Mmu4a11MNDZ7Sg5u9a
X-PARTNER-ID7fb118fb-2738-4886-9817-8a2c4de43001
X-EXTERNAL-ID41807553358950093184162180797837
CHANNEL-ID95221

Request Body

Field NameField TypeMandatoryField Description
virtualAccountNameString(255MThe customer name.
virtualAccountEmailString(255)MThe customer’s email.
virtualAccountPhoneString(30)MThe customer’s phone number.
trxIdString(36)MTransaction ID in Partner system
totalAmountObjectM
totalAmount.valueString (16, 2)MTransaction Amount.
totalAmount.currencyString (3)MThe currency of the value paid. Should be IDR.
billDetailsArray of ObjectMBilling address detail.
billDetails.billCodeStringOBilling address code.
billDetails.billNoStringOBilling address number.
billDetails.billNameStringMBilling address name.
billDetails.billShortNameStringOBilling address short name.
billDetails.billDescriptionObjectOBill Description
billDetails.billDescription.englishStringOEnglish version description.
billDetails.billDescription.indonesiaStringOBahasa version description.
billDetails.billSubCompanyStringOPartner's product code
billDetails.billAmountObjectO
billDetails.billAmount.valueStringMThe numeric string of the amount up to two decimal places.
billDetails.billAmount.currencyStringMCurrency of bill amount based on ISO 4217
billDetails.additionalInfoObjectMAdditional Information
expiredDateStringMExpired Date transaction.
addtionalInfoObjectMAdditional Information
addtionalInfo.enabledh2hpaymentsIntegerMEnable H2H Payments.
{ 

    "virtualAccountName": "Jokul Doe", 
    "virtualAccountEmail": "[email protected]", 
    "virtualAccountPhone": "6281828384858", 
    "trxId": "test1", 
    "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": {} 
        } 
    ], 
    "expiredDate": "2024-08-23T07:44:11+07:00", 
    "additionalInfo": { 
        "enabledh2hpayments": 4 
    } 
} 

Response Body

referenceNoStringMNumber Reference
responseCodeString(7)MStatus code of transaction charge result.
responseMessageString(150)MDescription of transaction charge result.
virtualAccountDataObjectMObject Virtual Account Data
virtualAccountData.virtualAccountNoString(28)MpartnerServiceId (8 digit left padding space) + customerNo (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo
{
  "referenceNo": "T24110664549",
  "responseCode": "2002700",
  "responseMessage": "Request has been processed successfully",
  "virtualAccountData": {
    "virtualAccountNo": "2035241100000664549"
  }
}

List Response Code

Response CodeHTTP StatusDescription
2002700200Successful
4002701400Invalid format