Virtual Account SNAP

Payment VA (NOTIFY)

Notifikasi saat pembayaran sukses

FieldValue
URL${ROOT_URL}/api/v1.0/transfer-va/payment
MethodPOST
Endpoint/transfer-va/payment
Service Code25
Version1.0
ServiceGrouptransfer-va
ProductTypepayment

Notifikasi saat pembayaran sukses

Request

ParameterRequiredTypeLengthRemarks
Content-TypeMString-Nilai tetap application/json
AuthorizationCStringVariabelNilai yang dikembalikan oleh antarmuka permintaan access_token, perlu diisi jika memilih metode tanda tangan enkripsi simetris
X-TIMESTAMPMString64Waktu Jakarta Indonesia, format 2021-11-29T09:22:18+07:00
X-PARTNER-IDMString36ID Merchant
X-EXTERNAL-IDMString12ID Permintaan
X-SIGNATUREMStringVariabelSignature. Untuk detailnya cek Cara Membuat Signature
X-IP-ADDRESSMString15IP Klien (IPv4)

Body

ParameterRequiredTypeLengthRemarks
partnerServiceIdMString8ID Merchant
customerNoMString20Nilai tetap 00000000000000000000
virtualAccountNoMString28virtualAccountNo
virtualAccountNameMString255Pembayar
virtualAccountEmailOString255Email
virtualAccountPhoneOString30Nomor Ponsel, Format: 62xxxxxxxxxxxxx
trxIdCString64Unique identifier generated by Partner
paymentRequestIdMString128Unique identifier generated by PJP. Nomor Transaksi Platform
channelCodeONumber4Channel code based on ISO 18245
hashedSourceAccountNoOString32Source account number in hash
sourceBankCodeOString3Source account bank code based on
+ paidAmountMObject
- ValueMString (ISO4217)16,2Paid Amount with 2 decimal
- CurrencyMString3Currency, tetap kirim: IDR
+ cumulativePaymentAmountOObject
- ValueMString (ISO4217)16,2Transaction Amount
- CurrencyMString3Currency, tetap kirim: IDR
paidBillsOString6Hexadecimal format of binary of flag of paid bills
+ totalAmountOObject
- ValueMString (ISO4217)16,2Transaction Amount.
- CurrencyMString3Currency, tetap kirim: IDR
trxDateTimeODate25PJP internal system datetime with timezone, which follows the ISO-8601 standard
referenceNoOString64Payment auth code generated by PJP, Nomor Transaksi Platform
journalNumOString6Sequence journal number in PJP Core System
paymentTypeOString1Type of payment
flagAdviseOString1Status is this a retry notification, N: No, Y: Yes
subCompanyOString5Sub Company code generated by Partner
+ billDetailsOArray of ObjectsArray with maximum 24 Objects
- billCodeOString2From Inquiry Response
- billNoOString18From Inquiry Response
- billNameOString20From Inquiry Response
- billShortNameOString10From Inquiry Response
+ billDescriptionOObjectFrom Inquiry Response
- englishOString18From Inquiry Response
- indonesiaOString18From Inquiry Response
- billSubCompanyOString5From Inquiry Response
+ billAmountOObject
- ValueMString (ISO4217)16,2Transaction Amount. From Inquiry Response
- CurrencyMString3Currency, tetap kirim: IDR
+ additionalInfoOObjectunlimitedFrom Inquiry Response
- BillReferenceNoONumber15Bill auth code generated by PJP
+ freeTextsOArray of ObjectsArray with maximum 25 Objects
- englishOString32Will be shown in Channel
- indonesiaOString32Will be shown in Channel
+ additionalInfoOObject
- transFeeRateOdecimal(8,6)NoTarif Biaya Transaksi
- transFeeAmountOdecimal(12,2)NoBiaya Per Transaksi
- totalTransFeeOdecimal(12,2)NoTotal Tarif Biaya Transaksi (tidak termasuk PPN)
- vatFeeOdecimal(12,2)NoPajak
- payerOString(60)NoPembayar Sebenarnya
- accountNoOString(32)NoNomor Rekening Pembayar Sebenarnya

Example

POST .../v1.0/transfer-va/payment 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":"12345678901234567890",
   "virtualAccountNo":"  08889912345678901234567890",
   "virtualAccountName":"Jokul Doe",
   "virtualAccountEmail":"jokul@email.com",
   "virtualAccountPhone":"6281828384858",
   "trxId":"abcdefgh1234",
   "paymentRequestId":"abcdef-123456-abcdef",
   "channelCode":6011,
   "hashedSourceAccountNo":"abcdefghijklmnopqrstuvwxyz123456",
   "sourceBankCode":"008",
   "paidAmount":{
      "value":"12345678.00",
      "currency":"IDR"
   },
   "cumulativePaymentAmount":{
      "value":"12345678.00",
      "currency":"IDR"
   },
   "paidBills":"95000",
   "totalAmount":{
      "value":"12345678.00",
      "currency":"IDR"
   },
   "trxDateTime":"20201231T235959Z",
   "referenceNo":"123456789012345",
   "journalNum":"123456",
   "paymentType":1,
   "flagAdvise":"Y",
   "subCompany":"12345",
   "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":{

         },
         "billReferenceNo":"123456789012345"
      }
   ],
   "freeTexts":[
      {
         "english":"Free text",
         "indonesia":"Tulisan bebas"
      }
   ],
   "additionalInfo":{
       "transFeeRate": "0",
       "transFeeAmount": "0",
       "totalTransFee": "0",
       "vatFee": "0"
   }
}

Response

Header

ParameterRequiredTypeLengthRemarks
Content-TypeMString-Nilai tetap application/json
X-TIMESTAMPMString64Waktu Jakarta Indonesia, format 2021-11-29T09:22:18+07:00

Body

ParameterRequiredTypeLengthRemarks
responseCodeMString7Response Code. response code = HTTP status code + service code + case code
responseMessageMString150Response Description
+ virtualAccountDataMObject
+ paymentFlagReasonOObjectReason for Payment Status multi language
- indonesiaOString200Reason for Payment Status in English
- englishOString200Reason for inquiryStatus in Bahasa
- partnerServiceIdMString8Derivative of X-PARTNER-ID , similar to company code,
- customerNoMString20Nilai tetap 00000000000000000000
- virtualAccountNoMString28virtualAccountNo
- virtualAccountNameMString255Customer name
- virtualAccountEmailOString255Customer email
- virtualAccountPhoneOString30Customer's phone number
- trxIdOString32From Payment Request
- paymentRequestIdMString128From Payment Request
+ paidAmountOObject
- ValueMString (ISO4217)16,2Transaction Amount.
- CurrencyMString3Currency, tetap kirim: IDR
- paidBillsOString6From Payment Request
+ totalAmountOObject
- ValueMString (ISO4217)16,2Transaction Amount. Contoh: 10000.00 , Static VA tetap kirim: 0.00
- CurrencyMString3Currency, tetap kirim: IDR
- trxDateTimeODate25From Payment Request
- referenceNoOString15From Payment Request
- journalNumOString6From Payment Request
- paymentTypeOString1From Payment Request
- flagAdviseOString1From Payment Request
- paymentFlagStatusOString2Status for Payment Flag from Partner
+ billDetailsOArray of ObjectsArray with maximum 24 Objects
- billerReferenceIdO64From Inquiry Response
- billCodeOString2From Inquiry Response
- billNoOString18From Inquiry Response
- billNameOString20From Inquiry Response
- billShortNameOString10From Inquiry Response
+ billDescriptionOObjectFrom Inquiry Response
- englishOString18From Inquiry Response
- indonesiaOString18From Inquiry Response
- billSubCompanyOString5From Inquiry Response
+ billAmountOObject
- ValueMString (ISO4217)16,2Transaction Amount.
- CurrencyMString3Currency, tetap kirim: IDR
+ additionalInfoOObjectunlimitedFrom Inquiry Response
- statusOString2Payment status for specific Bill
+ reasonOObjectReason for Payment Status for specific Bill multi language
- englishOString64Reason for Payment Status for specific Bill in English
- indonesiaOString64Reason for Payment Status for specific Bill in Bahasa
+ freeTextsOArray of ObjectsArray with maximum 25 Objects
- englishOString32Will be shown in Channel
- indonesiaOString32Will be shown in Channel
+ additionalInfoOObject
- transFeeRateOdecimal(8,6)NoTarif Biaya Transaksi
- transFeeAmountOdecimal(12,2)NoBiaya Per Transaksi
- totalTransFeeOdecimal(12,2)NoTotal Tarif Biaya Transaksi (tidak termasuk PPN)
- vatFeeOdecimal(12,2)NoPajak
- payerOString(60)NoPembayar Sebenarnya
- accountNoOString(32)NoNomor Rekening Pembayar Sebenarnya

paymentFlagStatus

CodeDESC
00Success
01Initiated
02Paying
03Pending
04Refunded
05Canceled
06Failed
07Not found

Example

Content-type: application/json
X-TIMESTAMP: 2020-12-21T14:36:19+07:00

{
   "responseCode":"2002500",
   "responseMessage":"Success",
   "virtualAccountData":{
      "paymentFlagReason":{
         "english":"Success",
         "indonesia":"Sukses"
      },
      "partnerServiceId":" 088899",
      "customerNo":"12345678901234567890",
      "virtualAccountNo":"  08889912345678901234567890",
      "virtualAccountName":"Jokul Doe",
      "virtualAccountEmail":"jokul@email.com",
      "virtualAccountPhone":"6281828384858",
      "trxId":"abcdefgh1234",
      "paymentRequestId":"abcdef-123456-abcdef",
      "paidAmount":{
         "value":"12345678.00",
         "currency":"IDR"
      },
      "paidBills":"95000",
      "totalAmount":{
         "value":"12345678.00",
         "currency":"IDR"
      },
      "trxDateTime":"20201231T235959Z",
      "referenceNo":"123456789012345",
      "journalNum":"123456",
      "paymentType":1,
      "flagAdvise":"Y",
      "paymentFlagStatus":"00",
      "billDetails":[
         {
            "billerReferenceId":"123456789012345678",
            "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":{

            },
            "status":"00",
            "reason":{
               "english":"Success",
               "indonesia":"Sukses"
            }
         }
      ],
      "freeTexts":[
         {
            "english":"Free text",
            "indonesia":"Tulisan bebas"
         }
      ]
   },
   "additionalInfo":{

   }
}

Status Inquiry VA (SNAP)

Cek status Virtual Account melalui layanan transfer-va SNAP.

Update Virtual Account

Panduan lengkap untuk memperbarui Virtual Account menggunakan API Paylabs.

On this page

Request
Header
Body
Example
Response
Header
Body
paymentFlagStatus
Example