Verified BursaPay gateway workflow: Explains developer-initiated bank transfers and their completion/failure states.
1. Overview & Purpose
The gateway supports developer transfers and uses Paystack transfer.success and transfer.failed events to complete or reverse wallet reservations.
2. Requirements & Setup
Live Mode and the relevant transfer scope are required for real payouts.
3. Step-by-Step Workflow
- Create the transfer request.
- Store the transfer reference/code.
- Wait for the transfer outcome webhook.
- Reconcile the wallet after success or failure.
4. Rules & Troubleshooting
The webhook implementation is designed to be idempotent and restores reserved funds when a transfer fails.
5. Verification & Next Steps
Do not treat a submitted transfer as final settlement until its completion state is confirmed.