v1

latestOpenAPI 3.1.02026-07-2418201.6 MB

Virtual Transfer API

This API enables merchants to seamlessly transfer funds between virtual accounts (VAs).

post/v3/banking/account/virtual_transfer

Headers

client_idstring

Decentro assigned client_id during on boarding.

client_secretstring

Decentro assigned client_secret during on boarding.

Request body

reference_idstring required

A unique ID assigned by clients for every API request.

consumer_urnstring required

A unique identifier assigned to client's by Decentro during On boarding.

from_virtual_accountstring required

The virtual account from which money will be debited.

to_virtual_accountstring required

The virtual account to which money will be credited.

amountstring required

The amount to be transferred between the virtual accounts.

purpose_messagestring required

The purpose message for the virtual transfer.

Response

200

decentro_txn_idstring

api_statusstring

messagestring

response_keystring

Example response

{
  "decentro_txn_id": "2C8FDC24E3184929850F45BF511A10C2",
  "api_status": "SUCCESS",
  "message": "Funds transfer request processed successful",
  "data": {
    "transaction_status": "SUCCESS",
    "transaction_status_description": "Funds transferred successfully",
    "from_virtual_account": "4625255142591036",
    "to_virtual_account": "4625251223174264",
    "transaction_date": "2025-01-10",
    "from_virtual_account_updated_balance": 8000,
    "to_virtual_account_updated_balance": 2000
  },
  "response_key": "success_transaction_status_successful"
}