BursaPay Logo
Knowledge Base
Ticket Sign In
Help Center > Vendor Finance, Escrow & Disputes > Handling Payout Bank Account Reversals & NIBSS Transfer Error Codes

Handling Payout Bank Account Reversals & NIBSS Transfer Error Codes

Published 2026-08-17 5 min read
Who is this article for?
This guide is for Vendors, Support Staff seeking operational guidance on BursaPay workflows.

UI Navigation Path (Step-by-Step)

  1. If bank transfer fails, system receives Paystack webhook <code>transfer.failed</code>
  2. Withdrawal status changes to 'Rejected / Reversed'
  3. The requested withdrawal amount is immediately restored to your available wallet balance
  4. Update your bank account details at /vendor/payout/ and resubmit
Executive Guide (): How BursaPay handles failed interbank transfers (NIBSS error codes, invalid account numbers, bank downtime) and automated wallet balance reversals.

1. Overview & Operational Purpose

In the BursaPay ecosystem, Handling Payout Bank Account Reversals & NIBSS Transfer Error Codes represents a core operational workflow designed for Vendors, Support Staff. This comprehensive guide provides step-by-step instructions, system rules, and technical specifications to ensure seamless execution without errors or administrative delays.

Understanding this workflow ensures compliance with platform security protocols, accuracy in financial reporting, and efficient service delivery for all associated stakeholders.

2. Prerequisites & Required Documentation

Before proceeding with this workflow, verify that you have gathered all mandatory prerequisites and meet the necessary operational criteria:

  • Verified Account Credentials: Ensure you are logged in with the appropriate user persona and role permissions required for this task.
  • Active Identification & Records: Relevant records (such as Matriculation Number, CAC Business Registration, or Payment Reference IDs) must be valid and active.
  • Network & Device Compliance: Access via a secure web browser with standard security headers enabled to receive instant verification alerts.

3. Detailed Step-by-Step UI Execution Path

Follow these exact steps within your dashboard interface to complete the process:

  1. Step 1: If bank transfer fails, system receives Paystack webhook transfer.failed
  2. Step 2: Withdrawal status changes to 'Rejected / Reversed'
  3. Step 3: The requested withdrawal amount is immediately restored to your available wallet balance
  4. Step 4: Update your bank account details at /vendor/payout/ and resubmit
Important Notice & Safety Protocol: Ensure all input data is thoroughly cross-checked prior to final submission. Incorrect entries may require manual administrative review and prolong processing times up to 48 working hours.

4. System Boundaries, Limits & Operational Rules

To ensure system integrity and compliance, the following operational limits and validation rules apply to this feature:

Metric / Parameter Standard Requirement Validation Scope
Access Control Scope Target Audience (Vendors, Support Staff) Role-Based Access Control (RBAC)
Verification Standard System OTP & Compliance Audit Automated & Manual Review
Service SLA Instant to 48 Hours Transaction & Document Verification Window

5. Processing SLA, Verification & Next Steps

Upon completing the step-by-step instructions above, your submission is immediately logged into the BursaPay audit engine. You will receive an automated confirmation email detailing your transaction status, reference code, and next steps. For requests requiring manual compliance review, allow up to 24 to 48 working hours for notification of final approval.

Was this article useful?

Related Articles

BursaPay Escrow Architecture: How Tri-Party Escrow Protects Vendors & Clients Escrow Wallet Breakdown: Available Balance vs. Pending Escrow Release Submitting a Withdrawal Request: Payout Accounts, Min Thresholds & Validations Platform Commission Fee Tier Structure: 5%, 4%, 3.5%, and 3% Sliding Rates
Ask Bursa AI