AppZone API Documentation
  • Overview
    • Welcome
    • Getting Started
    • Enterprise User Oauth
  • Account
    • Account API
      • Create Account
      • Account Enquiry
      • Freeze Account
      • Unfreeze Account
      • Check Freeze Status
      • Place Lien on Account
      • Remove Lien on Account
      • Check Lien Status
      • Activate Post-No-Debit on Account
      • Deactivate Post-No-Debit on Account
      • Check Post-No-Debit Status
      • Retrieve BVN Details
      • Create Customer and Account
      • Update Account Tier2
      • Get Bank One Balance Enquiry
      • Generate Account Statement
      • Get Active Savings Accounts by CustomerID
      • Search Transactions
      • Get Transactions
  • Customer
    • Customer API
      • Create Customer
      • Update Customer
      • Get Customer by Account Number
  • Loans
    • Loan API
      • Get Loans By Customer Id
      • Get Loan Repayment Schedule
      • Loan Creation Application 2
      • Get Loan Account Balance 2
  • Account Officer
  • Standing Order
    • Standing Order API
      • Standing Order Creation Application2
      • Get Standing Orders By Debit Account Number
      • Cancel Standing Order
  • Fixed Deposit
    • Fixed Deposits API
      • Create Fixed Deposit Account
      • Get Fixed Deposit Account By Account Number
      • Get Fixed Deposit Account By Liquidation Account
      • Get Fixed Deposit Account By Phone Number
  • Transfers
    • Transfer API
      • Name Enquiry
      • Intra Bank (Local) Fund Transfer
      • Intra Bank Transfer
  • Cards
    • Cards API
      • Retrieve Institution Configurations
      • Card Request
      • Get Customer Cards
      • Hotlist Customer Card
      • Check Card Generation Status
      • Link Card to Customer Account
      • Freeze Cards
      • Unfreeze Cards
      • Add Transaction Limit to Customer Card
      • View Transaction Limit on Customer Card
      • Update Transaction Limit on Customer Card
      • Disable channel for customer card
      • Get Card Delivery Options
      • Re-Enable Channel for Customer Card
  • Overdraft
    • Overdraft API
      • Create Overdraft
      • Get Overdraft Interests
      • Get Overdraft Fees
  • Transactions
    • Transactions API
      • Transaction Status Confirmation
      • Credit Customer Account
      • Debit Customer Account
      • Reversals
  • Bills Payment
    • Bills Payment API
      • Get Commercial Bank
      • Get Billers
      • Get Billers Category
      • Get Payment Items
      • Initiate Bills Payment Transaction
  • Messaging
    • Save Bulk SMS
    • Save Email
Powered by GitBook
On this page
  1. Transfers

Transfer API

Transfers endpoint are used for end to end transfers within and across acc

It is very important to note that all transfer request must be authenticated with your authentication token.

Possible transfer responses and their meaning

Handling Transaction Response

IsSuccessful

This response parameter is used to determine the status of the initiated request.

  • If response is False, a possible system error or invalid request occurred. Transaction should be initiated again and can be initiated with the same transaction reference.

  • If response is True, proceed to check the response code to determine the status of the transaction.

ResponseCode

This response parameter is used to determine the status of the transaction.

  • If respond code is 00, then the transaction is successful

  • If any of the “pending” response codes is gotten, then a TSQ is required to determine the actual status of the transaction after the interval time stated for each transaction type

  • If any other response code is received, the transaction failed, and the request can be initiated with a new transaction reference.

  • If No Response is received, a transaction status query is required to determine the status of the transaction after the interval time stated for each transaction type.

Handling TSQ Response

IsSuccessful
  • This response parameter is used to determine the status of the initiated TSQ request.

  • If response is False, possible system error or invalid request occurred. The TSQ request should be initiated again.

  • If response is True, proceed to check the “Status” to determine the actual status of the initiated funds transfer request.

Status

This response parameter is used to determine the status of the initiated funds transfer request

  • If status is Successful, then the initiated funds transfer request was processed successfully

  • If status is Failed, then the initiated funds transfer request failed, a new request can be initiated with a new transaction reference.

  • If status is Pending, then we are unable to determine the status of the transaction. Kindly initiate another TSQ request after the interval time stated for each transaction type. if outcome persists, please contact support

A reversal request should NEVER be initiated for INTERBANK transfer irrespective of the transfer or TSQ status, while reversals for other transaction types such as (DEBIT, CREDIT, LOCALFUNDSTRANSFER) can be initiated after 90 seconds of a successful transaction)

Handling Reversal Response

IsSuccessful

This response parameter is used to determine the status of the initiated reversal request.

  • If response is False, a possible system error or invalid request occurred. The reversal request should be initiated again.

  • If response is True, proceed to check the “Status” to determine the actual status of the reversal.

Status

This response parameter is used to determine the status of the reversal

If status is Successful, then the reversal was processed successfully.

If status is Failed, then the reversal should be initiated again.

PreviousGet Fixed Deposit Account By Phone NumberNextName Enquiry

Last updated 2 years ago