Virtual Account Services
  1. Notifications
Virtual Account Services
  • Introduction
  • Terminologies
  • Webhooks
  • Authentication
  • Account
    • Create Account
      POST
    • Rename Account
      POST
    • Balance Inquiry
      GET
    • 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
    • Get Institutions
      GET
    • Name Inquiry
      POST
    • Interbank Transfer
      POST
    • Interbank Transfer [Sync]
      POST
    • Transfer Query
      GET
    • Transfer Enquiry
      GET
    • Virtual Account Intrabank Transfer
      POST
    • Core Banking Intrabank Transfer
      POST
    • Collection Accounts Intrabank Transfer
      POST
  • Invoice
    • Create Invoice
    • Get Invoice Detail
    • List Merchant Invoices
  • Refunds
    • Initiate Refund
    • Get Refund Status
    • Get Refunds
  • Notifications
    • Notification
    • Send Notification
      POST
  • Merchant
    • Account
      • Get Account
      • Activate Sub Ledger For Merchant
      • Get SubLedger Callback Urls
      • Set SubLedger Callback Urls
      • Get Collection Accounts
    • Transfer
      • Get Transfer History
      • Get Subledger transfers
      • Get Transfer Details
      • Name Inquiry
    • Refund
      • Refund Details
  • Admin
    • Accounting
      • Get GL Accounts
      • Get Classification Codes
    • Dashboard
      • Dashboard Summary
      • Dashboard Transactions
      • Dashboard Transaction Details
    • Group Codes
      • Get Group Codes
      • Set Collection Account
      • Create Group Code
    • Reporting
      • Get Report Types
      • Get Report Parameters
      • Create Report
      • Get Reports
      • Get Reports Details
  1. Notifications

Send Notification

POST
/transfer/notify/{transactionReference}
This operation sends transaction notifications based on the specified transactionReference. It can be used for testing or to resend notifications payload incase of integration issues.

Path Parameter#

Field NameTypeRequiredDescription
transactionReferencestringtrueThe unique reference code used to identify and track the transaction being queried.

Response Body#

Field NameTypeDescription
transactionTypestringThe type of transaction (e.g., transfer, deposit, withdrawal).
amountdecimalThe amount involved in the transaction.
narrationstringA brief description or purpose of the transaction.
classificationCodestringA code used to categorize the transaction type.
successbooleanIndicates whether the transaction was successful (true or false).
traceIDstringA unique identifier used for tracking the transaction.
transactionReferencestringA reference ID associated with the transaction.
accountIDstringThe unique identifier of the account involved in the transaction.
transactionTimestringThe timestamp indicating when the transaction occurred.

Request

Path Params

Body Params application/json

Example
{}

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 --request POST '/transfer/notify/100004241122204422122554550927' \
--header 'Content-Type: application/json' \
--data-raw '{}'

Responses

🟢200Send Notification
application/json
Body

Example
{
    "transactionType": "CREDIT",
    "amount": 69000,
    "narration": "Transfer from BLESSED AUSTIN ABOH",
    "classificationCode": "NIP0001_CREDIT",
    "success": true,
    "traceID": "0580470e-de67-4abb-abf4-dacff6176171",
    "transactionReference": "100004241122204422122554550927",
    "accountID": "9000015181",
    "transactionTime": "2024-11-22T20:44:33.000+00:00"
}
Modified at 2025-03-15 08:17:22
Previous
Notification
Next
Get Account
Built with