Betaalflow

Overzicht betaalmethoden

Methode	Via	Kosten	Automatisch markeren
Lokale bank ~90%	Sentoo A2A	1%, max AWG 1,50	Webhook
Visa/Mastercard	Sentoo Cards	Variabel + setup fee	Webhook
Creditcard (direct)	Klant betaalt zelf	5% processing fee	Handmatig
Cash	Balie	Geen	Handmatig
PIN	Pinautomaat	Bankkosten	Handmatig

Facturen worden volledig in de eigen app gegenereerd. Invoice2go wordt niet meer gebruikt. Factuurlogica zit in de Hono API, PDF rendering via Forme PDF (Rust/WASM op CF Workers), betaallinks via Sentoo.

POST /api/invoices           → Factuur aanmaken (berekening, kortingen)
POST /api/invoices/:id/pdf   → PDF genereren (Forme PDF)
POST /api/invoices/:id/send  → Betaallink Sentoo + email Resend

Betaalregels per dienst

Dienst	Betaalmoment	Percentage
Testdag	Vooraf	100%
Daycare drop-in	Per bezoek	100%
Paw Voucher	Bij aankoop	100%
Unlimited	Maandelijks	100%
Boarding	50% vooraf + 50% bij check-in	Gesplitst
Training	Vooraf	100%
Bath and Brush	Per bezoek	100%

Sentoo A2A flow

App maakt transactie aan via Sentoo REST API

POST /transactions met { amount, description, expiry_date } — response: payment_url + QR code
App toont betaallink en QR aan klant

In portaal, via email of WhatsApp
Klant kiest bank op Sentoo tussenpagina

Aruba Bank / CMB / Banco di Caribe / etc.
Klant wordt doorgestuurd naar eigen bankapp

Klant autoriseert met PIN / vingerafdruk / token
Sentoo pusht webhook naar de app

POST /api/payments/webhook met { transaction_id, status: "SUCCESS" }
App markeert factuur automatisch als betaald

Notificatie naar klant (betalingsbevestiging)

Transactiestatussen

Status	Betekenis	Actie in app
`issued`	Transactie aangemaakt	—
`pending`	Wacht op betaling	—
`success`	Betaald	Factuur naar betaald
`failed`	Mislukt	Notificatie klant
`cancelled`	Geannuleerd	—
`expired`	Verlopen	Herinnering sturen

Concept-factuur flow (boarding/langdurig)

Bij langdurig verblijf en boekingen met korting:

Systeem detecteert langdurig verblijf / grote boeking
Concept-factuur wordt aangemaakt — voorstel korting
Personeel controleert — handmatige aanpassing mogelijk
Definitieve factuur — versturen via email / WhatsApp
Klant betaalt via Sentoo

Maandelijkse flow (Unlimited abonnement)

Facturatiedag (cron job via Supabase pg_cron)
- Controleer: welke subscriptions zijn aan verlenging toe?
- Maak factuur aan per abonnement
- Maak Sentoo transactie aan via API
- Stuur betaallink via Resend (email)
- Stel volgende facturatiedatum in op +1 maand
Klant betaalt

Sentoo webhook markeert factuur automatisch als betaald, gevolgd door bevestigingsmail.
Niet betaald — escalatie
Non-payment escalatie
- Na 3 dagen — automatische herinnering
- Na 7 dagen — tweede herinnering
- Na 14 dagen — notificatie admin, optioneel blokkering

Handmatig markeren (cash / pin)

Ga naar /admin/invoices/[id]
Klik op “Markeer als betaald”
Kies betaalmethode: Cash / PIN
Bevestig bedrag
Vastgelegd: bedrag, methode, tijdstip, medewerker

Betaaloverzicht (admin dashboard)

Overzicht wie betaald heeft en wie nog openstaat
Filter: openstaand / gedeeltelijk betaald / volledig betaald
Automatische reminders via email voor openstaande facturen

Webhook beveiliging

Sentoo ondertekent elke betaalmelding met een geheime sleutel. De app controleert deze handtekening voordat de betaalstatus wordt bijgewerkt. Dit voorkomt dat iemand nep-betalingen kan insturen. Technische details staan in de Sentoo integratie documentatie.

Belastingen op facturen

Alle facturen bevatten Arubaanse belastingen:

Belasting	Percentage
BBO (Bestemmingsheffing)	6%
BAZV (Zorgverzekering)	1.5%

Belastingen worden inbegrepen in het totaalbedrag (niet bovenop). Zie voorbeeldfactuur: subtotaal AWG 576, inclusief BBO AWG 32.15 en BAZV AWG 8.04.

Bankgegevens op factuur

Elke factuur bevat de bankgegevens voor directe overschrijving:

Dog Hotel Aruba N.V
Aruba Bank N.V, Camacuri 12
Rekeningnummer: 6011060190
SWIFT: ARUBAWAX