1. 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
      POST
    • Transfer Enquiry
      GET
    • Get Institutions
      GET
    • Virtual Account Intrabank Transfer
      POST
    • Intrabank Transfer Query
      GET
    • Collection Accounts Intrabank Transfer
      POST
    • Name Inquiry
      POST
    • Core Banking Intrabank Transfer
      POST
    • Transfer Query
      GET
    • Interbank Transfer [Sync]
      POST
  • Invoice
    • Create Invoice
    • Get Invoice Detail
    • Get Invoice Status
    • List Merchant Invoices
  • 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. Transfer

Virtual Account Intrabank Transfer

POST
/transfer/intra
This API transfers funds within the same bank from a source account to another virtual account.

Request Body#

Field NameTypeRequiredDescription
fromAccountIDstringTRUEThe unique identifier of the source account to be debited.
toAccountIDstringTRUEThe unique identifier of the destination sub-ledger account to be credited.
amountdecimalTRUEThe amount to be transferred.
narrationstringTRUEA brief, precise description of the transfer purpose.
transactionReferencestringTRUEUnique Transaction Reference

Response Body#

Field NameTypeDescription
accountIDstringThe destination sub-ledger account that received the credit (toAccountID).
classificationCodestringThe classification code associated with the transfer transaction.
amountdecimalThe transferred amount.
narrationstringA description or note regarding the transfer.
transactionReferencestringA unique reference identifier generated for the transaction.
transactionTypestringIndicates the type of transaction; will be "CREDIT" for this operation.
successbooleanConfirms whether the transfer was successfully processed.
traceIDstringA unique tracking identifier for the transaction.
transactionTimestringThe timestamp when the transaction was processed.

Request

Body Params application/json

Example
{
  "fromAccountID": "4000000178",
  "toAccountID": "4000000192",
  "classificationCode": "0",
  "amount": 7,
  "narration": "Sample narration",
  "transactionReference": "NG-310432565"
}

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' \
--header 'Content-Type: application/json' \
--data '{
  "fromAccountID": "4000000178",
  "toAccountID": "4000000192",
  "classificationCode": "0",
  "amount": 7,
  "narration": "Sample narration",
  "transactionReference": "NG-310432565"
}'

Responses

🟢200Response
application/json
Bodyapplication/json

Example
{
  "transactionType": "CREDIT",
  "amount": 7,
  "narration": "Sample narration",
  "classificationCode": "0",
  "success": true,
  "traceID": "37e19a43-2c76-48df-b228-ab6ef1813cc5",
  "transactionReference": "0-SL-TRSF-CRDT",
  "accountID": "7074443265",
  "transactionTime": "2023-09-11T03:16:03.839+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-02 12:41:29
Previous
Get Institutions
Next
Intrabank Transfer Query
Built with