1. Intrabank Transfer
Virtual Account Services
  • Introduction
  • Terminologies
  • Webhooks
  • Authentication
  • Account
    • Create Account
      POST
    • Balance Inquiry
      GET
    • Rename Account
      POST
    • Create Bulk Accounts
      POST
    • List Accounts
      GET
  • Transaction
    • Credit Account
      POST
    • Debit Account
      POST
    • Credit Account [Agency Banking]
      POST
    • Debit Account [Agency Banking]
      POST
    • Transaction Query
      GET
    • Transaction Details
      GET
    • Transaction History
      GET
  • Transfer
    • Interbank Transfer
      • Interbank Transfer
      • Interbank Transfer [Sync]
      • Transfer Query
      • Transfer Enquiry
    • Intrabank Transfer
      • Intrabank Transfer [Same Groupcode]
        POST
      • Intrabank Transfer [Different Group Codes]
        POST
      • Intrabank Transfer [Savings Account]
        POST
      • Intrabank Transfer Query
        GET
    • Name Inquiry
      POST
    • Get Institutions
      GET
  • Invoice
    • Create Invoice
      POST
    • Get Invoice Detail
      GET
    • Get Invoice Status
      GET
    • List Merchant Invoices
      GET
  • Refunds
    • Get Refunds
    • Initiate Refund
    • Get Refund Status
  • Notifications
    • Notification
    • Send Notification
  • Group Code
    • Create Group Code
  • Overdraft
    • Draw Overdraft
  • Merchant
    • Account
      • Get Account
      • Activate Sub Ledger For Merchant
      • Get SubLedger Callback Urls
      • Set SubLedger Callback Urls
      • Get Collection Accounts
    • Transfer
      • Get Transfer Details
      • Name Inquiry
      • Get Transfer History
      • Get Subledger transfers
    • Refund
      • Refund Details
    • Create Merchant Account
    • Activate Sub Ledger For Merchant
    • Get KYC Information
    • Get Group Code Collection Account
    • Get Collection Accounts
    • Set Collection Account
    • Get Transfer Details
    • Name Inquiry
  • Admin
    • Accounting
      • Get Classification Codes
      • Get GL Accounts
    • Dashboard
      • Dashboard Summary
      • Dashboard Transaction Details
      • Dashboard Transactions
    • Group Codes
      • Create Group Code
      • Set Collection Account
      • Get Group Codes
    • Reporting
      • Get Report Parameters
      • Get Reports
      • Create Report
      • Get Reports Details
      • Get Reports
    • Get Reports
    • Get Report Parameters
  • Schemas
    • VACreateGroupCodeRequest
    • SubLedgerGroup
    • InvalidParameterError
    • TransactionPointError
    • UnauthorizedError
    • SpringDefaultError
  1. Intrabank Transfer

Intrabank Transfer [Different Group Codes]

POST
/transfer/intra/collection-accounts
This API facilitates an intrabank transfer between virtual accounts that have different group codes(Parent Accou ts).

Request Body#

Field NameTypeRequiredDescription
fromAccountIDstringTRUEThe unique identifier of the account from which funds are debited.
toAccountIDstringTRUEThe unique identifier of the account to be credited.
amountdecimalTRUEThe amount to be transferred.
narrationstringTRUEA concise description of the transfer.
transactionReferencestringTRUEA unique reference for the transfer transaction.

Response Body#

Field NameTypeDescription
transactionTypestringThe type of transaction; will be CREDIT for this operation.
amountdecimalThe amount that was transferred.
narrationstringA description of the transaction, potentially including source account details.
classificationCodestringA code classifying the credit operation (e.g., SUBLEDGER_CREDIT).
successbooleanIndicates whether the transfer was successful.
traceIDstringA unique identifier for tracking the transaction.
transactionReferencestringThe unique reference generated for the transaction.
accountIDstringThe destination account that was credited.
transactionTimestringThe timestamp when the transaction was processed.

Request

Body Params application/json

Example
{
  "fromAccountID": "9000000054",
  "toAccountID": "9000000119",
  "amount": 3,
  "narration": "Sample narration",
  "transactionReference": "9348392"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/transfer/intra/collection-accounts' \
--header 'Content-Type: application/json' \
--data '{
  "fromAccountID": "9000000054",
  "toAccountID": "9000000119",
  "amount": 3,
  "narration": "Sample narration",
  "transactionReference": "9348392"
}'

Responses

🟢200Response
application/json
Bodyapplication/json

Example
{
  "transactionType": "CREDIT",
  "amount": 3,
  "narration": "Sample narration",
  "classificationCode": "SUBLEDGER_CREDIT",
  "success": true,
  "traceID": "a92bc056-282f-4d2c-80ae-cad57ae4b1e6",
  "transactionReference": "9348392-SL-TRSF-CRDT",
  "accountID": "0478358861",
  "transactionTime": "2024-10-23T12:49:31.381+00:00"
}
🟠400| Source | Error | When |
🟠401| Source | Error | When |
🟠403| Source | Error | When |
🟠404| Source | Error | When |
🟠409| Source | Error | When |
🔴500| Source | Error | When |
Modified at 2026-11-13 15:14:49
Previous
Intrabank Transfer [Same Groupcode]
Next
Intrabank Transfer [Savings Account]
Built with