When a disbursement enters a stuck state, it requires manual verification and resolution. A disbursement becomes stuck when the transfer result is unclear, typically due to network issues or payment provider errors.

Understanding stuck disbursements

A disbursement can become stuck in the following situations:

1. Network timeout - The request was sent to the payment provider, but no response was received
2. Payment provider server error - The payment provider returned an error that doesn't specify if the transfer was processed
3. Rollback failure - The transfer failed, but the automatic reversal (reversing the loan from "active" back to "approved" status) failed

Why manual resolution is necessary

When a disbursement is stuck, the system cannot automatically determine whether:

• The money was successfully transferred to the recipient
• The money is still held in the organization's account
• The loan needs to be reversed from "active" back to "approved" status

Manual verification with the payment provider is required to determine the actual state before taking action.

Prerequisites

• You must be authorized to resolve stuck disbursements
• Access to the payment provider's transaction records or support system

Steps to resolve

1. Log in to Symba Payments with a user account that is authorized to resolve stuck disbursements
2. Navigate to the Disbursal page
3. Locate the stuck disbursement in the disbursements list
   • Stuck disbursements have a status of stuck
   • The status message will indicate the reason (e.g., "Network timeout", "Server error", "Reversal failed")
4. Click the Resolve button for the stuck disbursement
5. Verify with the payment provider:
   • Log in to the payment provider's portal
   • Search for the transaction using the disbursement ID or reference number
   • Determine if the transfer succeeded or failed
6. Verify the loan status in Symba Microbanking:
   • Navigate to the loan details in Symba Microbanking
   • Check if the loan status is "Active" or still "Approved"
7. In the resolution dialog, choose the appropriate action:
   • Mark as Succeeded - If you verified the transfer completed successfully and the loan should remain active
   • Mark as Failed - If you verified the transfer did not complete and the loan should be reversed to approved status
8. If you choose Mark as Failed, the system will attempt to reverse the disbursement in Symba Microbanking
   • If the reversal succeeds, the disbursement will be marked as failed and the loan reversed to "approved" status
   • If the reversal fails, the disbursement remains stuck and requires escalation to Symba Global Support

Escalation

If the disbursement remains stuck after resolution attempts, or if you encounter an undodisbursal failure:

1. Document the following information:
   • Disbursement ID
   • Loan ID
   • Transaction reference from the payment provider
   • Screenshots of the payment provider's transaction status
   • Screenshots of the loan status in Symba Microbanking
   • Amount and recipient details
2. Contact Symba Global Support with this information
3. Do not attempt to manually adjust the loan status or balance without guidance from Symba Global Support

Related Topics

• Monitoring disbursements
• Refreshing status