v1

latestOpenAPI 3.1.02026-07-2418201.6 MB

Get Virtual Account Statement

This API can be used by platforms to fetch the statement of a virtual account.

get/v3/banking/account/statement

Query parameters

fromstring date-time required

The starting date and time when the statement needs to be fetched. Format: %Y-%m-%d %H:%M:%S'

tostring date-time required

The ending date and time when the statement needs to be fetched. Format: %Y-%m-%d %H:%M:%S'

consumer_urnstring required

A unique identifier assigned to each merchant by Decentro during onboarding.

virtual_account_numberstring

Virtual account number as requested by the platform.

pagestring required

The page number for viewing the account statement. Should be a valid positive integer.

custom_va_numberstring

The suffix part of the VA that uniquely identifies each VA. It can be from 6 -10 digit. Eg: va_suffix will be 000001 for virtual account number 46525000001

customer_va_identifierstring

Unique customer identifier that is mapped against the virtual account.

Headers

client_idstring required

client_secretstring required

x_on_behalf_ofstring

Optional header that allows parent merchant to consume the API on behalf of sub-merchant.

Response

200

decentro_txn_idstring

api_statusstring

messagestring

response_keystring

Example response

{
  "decentro_txn_id": "179BC4C397744F45AF27E40033566C16",
  "api_status": "SUCCESS",
  "message": "Statement fetched successfully.",
  "data": {
    "name": "jhon doe",
    "from": "2024-07-10T10:30:00",
    "to": "2024-07-21T00:16:54",
    "total_count": 151,
    "withdrawal_count": 77,
    "deposit_count": 74,
    "closing_balance": 702.5651,
    "statement": [
      {
        "timestamp": "2024-07-16T15:33:49",
        "description": "NA",
        "bank_reference_number": "5127037",
        "decentro_txn_id": "4C07B636347B410C849BA0316DFC8C01",
        "amount": 1,
        "updated_balance": 1,
        "type": "CREDIT",
        "transaction_type": "MAIN",
        "transaction_status": "SUCCESS",
        "transfer_type": "IMPS",
        "beneficiary_account_number": "YESB010035837506",
        "beneficiary_account_ifsc": "YESB0CMSNOC",
        "sender_account_number": "87654359000011",
        "sender_account_ifsc": "ICIC0000107"
      }
    ]
  },
  "response_key": "success_account_statement_fetched"
}