Verified BursaPay gateway workflow: Explains the verification step that turns a pending payment into a successful wallet credit path.
1. Overview & Purpose
The gateway verification flow updates the DeveloperPayment state, credits the developer wallet through the wallet service and dispatches the payment.success webhook after successful verification.
2. Requirements & Setup
Use the BursaPay payment reference returned during initialization.
3. Step-by-Step Workflow
- Receive the customer callback or webhook.
- Call POST /api/v1/payments/verify/ with the payment reference when needed.
- Confirm the returned status is success.
- Reconcile the resulting wallet and webhook state.
4. Rules & Troubleshooting
The implementation treats already-successful payments as safely processed rather than crediting the wallet again.
5. Verification & Next Steps
Use the webhook and verification mechanisms together rather than assuming a browser redirect alone is authoritative.