Verified BursaPay gateway workflow: Explains the invoice API and payment-state events associated with invoices.
1. Overview & Purpose
The gateway exposes /api/v1/invoices/ and webhook events including invoice.paid and invoice.overdue.
2. Requirements & Setup
Use the invoices permission scopes assigned to the API key.
3. Step-by-Step Workflow
- Create the invoice.
- Deliver the invoice to the intended customer.
- Monitor payment status.
- Reconcile invoice.paid or invoice.overdue events.
4. Rules & Troubleshooting
Invoice lifecycle events should be consumed idempotently just like payment events.
5. Verification & Next Steps
Keep the invoice ID linked to your own order/customer records.