Skip to main content

Virtual Account (VA) Settlement File

Document Version 1.0.4


The settlement file report is used by DANA to do reconciliation transaction. The settlement file gives detailed information about each transaction that affects funds settlement to DANA Bank accounts.

File NameVIRTUAL_ACCOUNT_[CHANNEL_ID]_YYYYMMDD.csv
(YYYYMMDD refer to the transaction date)
File Format.csv
FunctionThe settlement file report is used by DANA to do reconciliation transaction and provide detailed information about each transaction that affects funds settlement to DANA Bank accounts
Settlement Cut Off00.00.00
DelimiterComma
Related ServicesVirtual Account (VA)

File Generation

The following sections are the details on how the file is generated:

  1. Bank/merchant need to generate the settlement file T+1 after transaction.
  2. Bank/merchant will deliver the settlement file through SFTP.

File Format

FieldTypeDescription
PAYMENT_REQUEST_IDString1 - 64 char
Unique reference identifier generated by Bank system
Notes:
  • If payment comes from the Inquiry process, this value must be the same with inquiryRequestId
  • As an identifier for DANA in case do a reversal
REFERENCE_NOString1 - 64 char
Payment auth code generated by Bank
TRX_DATE_TIMEDatetime25 char
Bank internal system datetime with timezone, in format YYYY-MM-DDTHH:mm:ss+07:00. Time must be in GMT+7 (Jakarta time)
VIRTUAL_ACCOUNT_NOString1 - 28 char
Information of virtual account number which combine partnerServiceId and customerNo
VIRTUAL_ACCOUNT_NAMEString1 - 50 char
Customer name
HASHED_SOURCE_ACCOUNT_NOString1 - 32 char
Source account number in hash
CURRENCYString1 - 3 char
3-letter currency code, typically it’s IDR
TOTAL_AMOUNTLong1 - 32 char
Amount based on the minor currency
PAID_AMOUNTLong1 - 32 char
Settled net amount
FEE_AMOUNTLong1 - 32 char
Fee amount
Notes:
If fee calculate net off, put zero
VALUE_ADDED_TAXLong1 - 32 char
Put if value added tax exist
WITH_HOLDING_TAXLong1 - 32 char
Put if withholding tax exist

Example CSV File Format

Virtual Account (VA)
File NameVIRTUAL_ACCOUNT_[CHANNEL_ID]_20220404.csv
(20220404 refer to the transaction date)
Example FileDownload Example File
Success Transaction
PAYMENT_REQUEST_ID,REFERENCE_NO,TRX_DATE_TIME,VIRTUAL_ACCOUNT_NO,VIRTUAL_ACCOUNT_NAME,HASHED_SOURCE_ACCOUNT_NO,CURRENCY,TOTAL_AMOUNT,PAID_AMOUNT,FEE_AMOUNT,VALUE_ADDED_TAX,WITH_HOLDING_TAX
160755501286,2022021410121481030100166897500561786,2022-02-14T16:10:36+07:00,081568406663,123456,123456,IDR,12000,12250,227,23,0
182032937836,2022021410121481030100166737700558283,2022-02-14T18:23:16+07:00,08127416027,123456,123456,IDR,25000,25250,227,23,0
231624645364,2022021410121481030100166897500561792,2022-02-14T23:19:07+07:00,081568406663,123456,123456,IDR,20000,20250,227,23,0
Version 1.0.4 - Jan 26, 2024
Affected Solutions
Changes
  • Updated document format on Specification section
Version 1.0.3 - Mar 8, 2023
Affected Solutions
Changes
  • Updated the values in the Specifications table for Settlement Cut Off
  • Updated the values in the Specifications table for File Version
Version 1.0.1 - August 03, 2022
Affected Solutions
Changes
  • Changed the file name format
  • Updated the content of the file generation section
  • Updated the datetime format
  • Updated the file sample with the new datetime format
  • Updated the currency length
  • Updated the file version on the specification table
  • Changed “Settlement Time” into “Settlement Cut Off” on the specification section
  • Changed “Related API” into “Related Service” on the specification table
Version 1.0.0 - July 11, 2022
  • Initial Document
ask AIAI Assistant
Need help with our documentation?
Start from our frequently asked questions or feel free to ask anything else.

AI generated responses may contain mistakes.