Verified BursaPay workflow: Reconcile payment and transfer webhooks with the gateway's authoritative transaction states.
1. Overview & Purpose
Payment and transfer events can move records to success or failure and can trigger wallet/withdrawal updates.
2. Requirements & Setup
Keep a durable internal transaction reference and compare the webhook event against the current gateway record when necessary.
3. Step-by-Step Workflow
- Receive the event.
- Locate the developer payment/withdrawal/transfer.
- Check whether the target state is already applied.
- Apply the state change and corresponding wallet/ledger operation exactly once.
4. Rules & Troubleshooting
Never double-credit a wallet or double-release a reserved withdrawal because the same provider event was delivered twice.
5. Verification & Next Steps
Reconcile unusual cases using the gateway transaction and ledger references.