- One-time payments
- Subscription renewals
- Paid PayPal invoices
- Refunds
- Chargebacks & disputes
- Subscription status changes
How it works
- 1
PayPal webhook
PayPal tells us a payment, refund or dispute happened.
- 2
Verify & de-duplicate
We check PayPal's signature and ignore events we've already seen.
- 3
Rules route the event
A fixed table decides: invoice, storno, watch, or nothing. No AI here.
- 4
AI maps invoice lines + VAT
AI turns messy PayPal item data into clean invoice lines and VAT rates, and explains them.
- 5
Code validates → FIRA, or human review
Totals must match to the cent and VAT rates must be allowed. If anything is unsure, you review it first.
PayPal event → what we do
| PayPal event | What we do |
|---|---|
| PAYMENT.CAPTURE.COMPLETED | Invoice |
| PAYMENT.SALE.COMPLETED | Invoice (subscription renewal) |
| INVOICING.INVOICE.PAID | Invoice |
| PAYMENT.CAPTURE.REFUNDED / PAYMENT.SALE.REFUNDED | Storno (full or partial) |
| PAYMENT.CAPTURE.REVERSED | Storno (chargeback) |
| CUSTOMER.DISPUTE.CREATED / UPDATED | Watch the dispute, no document |
| CUSTOMER.DISPUTE.RESOLVED | Storno if the buyer won, otherwise no action |
| BILLING.SUBSCRIPTION.*, PAYMENT.CAPTURE.PENDING / DENIED | Logged, no document |
| Anything else | Logged and ignored |