1. OpenApi
OpenApi
  • OpenApi
    • Register
      • register
      • getState
      • getLga
    • Cashout
      • key exchange
      • purchase
      • balance
    • Transfer
      • nameEnquiry
      • banklist
      • transcation
      • orderStatus
    • Wallet
      • query balance
    • BillPayment
      • VTU Transaction
      • Data Validation
      • Data Transaction
      • Internet Validation
      • Internet Transaction
    • AccountTopup
      • create kuda static account
      • create kuda dynamic account
      • create wema static account
    • Authorization
      POST
    • Transcation Webhook
      POST
  1. OpenApi

Transfer

๐Ÿ”„ Transfer Transaction Workflow#

1. Name Enquiry#

API Call: nameEnquiry
Purpose: Retrieve the beneficiary's name before initiating a transfer.

2. Initiate Transfer#

API Call: transfer
Response Meanings:
โœ… Success โ†’ Deduction is successful, but the transfer status remains pending.
โŒ Failure โ†’ Deduction failed (transaction not processed).
โš  Note: A success response does not guarantee the final transfer success.

3. Check Transaction Status#

API Call: orderStatus
When to Call: After 30 seconds (from the transfer initiation).
Final Status:
โœ… Success โ†’ Transfer completed successfully.
โŒ Failure โ†’ Transfer failed (funds may be reversed).

4. Webhook Notifications#

Trigger Events:
1.
Reversal: If the transfer is rolled back.
2.
Success: When the transfer is confirmed successful.
Action Required: Your system must respond with HTTP 200 to acknowledge receipt.

๐Ÿ“Œ Key Notes#

Always verify the final status via orderStatus before notifying end-users.
Monitor webhooks 24/7 to handle reversals or successful transfers promptly.
Modified atย 2025-04-22 06:20:17
Previous
balance
Next
nameEnquiry
Built with