Post a transaction on virtual account

Post a transaction on virtual account

SecurityoAuth2
Request
Request Body schema: application/json

Create a new transaction (credit or debit) on a virtual account with transaction amount, date, and reference number

sourceRef
string

Unique reference number for the transaction

virtualAccountNumber
required
string

Virtual Account Number

creditDebitType
required
string

Type of transaction - Credit (money coming in) or Debit (money going out)

Enum: "Credit" "Debit"
transactionAmount
required
number <double>

Amount of the transaction

transactionDateTime
string <datetime>

Date and time when the transaction occurred

transactionDescription
string <= 255 characters
submittedBy
string

User ID or identifier of the person/system who submitted the transaction

sourceSystem
required
string
Default: "External"

System or source from which the transaction originated

Responses
200

OK

400

Bad request

401

You are not authorized to access the resource

403

Accessing the resource you were trying to reach is forbidden

404

The resource you were trying to reach is not found

500

Internal server error

post/v2/virtual-accounts/transactions
Request samples
application/json
{
  • "sourceRef": "TXN-2024-001234",
  • "virtualAccountNumber": "string",
  • "creditDebitType": "Credit",
  • "transactionAmount": 1000.5,
  • "transactionDateTime": "2024-01-15T10:30:00Z",
  • "transactionDescription": "string",
  • "submittedBy": "user123",
  • "sourceSystem": "External"
}
Response samples
application/json
{
  • "transactionId": "string",
  • "sourceRef": "TXN-2024-001234",
  • "accountName": "string",
  • "accountNumber": "string",
  • "amount": 0,
  • "feeAmount": 0,
  • "currency": "str",
  • "description": "string",
  • "date": "2019-08-24",
  • "paymentMethod": "ACH",
  • "direction": "Inbound",
  • "status": "string",
  • "postedOn": "string",
  • "postedBy": "string"
}