E8: Payment Processing¶
Overview¶
Bounded Context / Service: Payment Service
Goal: Process payments securely via Stripe and manage deferred payment workflows.
Priority: High
Primary User Roles¶
- Fan (for card payments)
- Finance Admin (for deferred payments)
Scope¶
In-Scope¶
- Stripe integration for card payments
- Payment intent creation and confirmation
- Refund processing via gateway
- Service fee calculation (6% configurable)
- VAT calculation (5% HOME, 0% AWAY; 25% on fee)
- Deferred payment flag on quotas
- Payment offer generation via e-racuni
- Manual bank reconciliation
- Invoice issuance after payment received
- Credit note creation for refunds
Out-of-Scope¶
- Multiple payment providers
- Installment payments
- Cryptocurrency payments
Features¶
| ID | Feature | Size | Description |
|---|---|---|---|
| E8-F1 | Stripe Integration | M | Payment intent and webhooks |
| E8-F2 | Service Fee Calculation | S | 6% fee with VAT |
| E8-F3 | Refund Processing | M | Stripe refunds and credit notes |
| E8-F4 | Deferred Payment Offer Generation | M | E-racuni payment offers |
| E8-F5 | E-Racuni Integration | M | Croatian e-invoicing API |
Dependencies¶
- Stripe API
- E-racuni API for invoicing
- Ticket service for order management
Risks & Open Questions¶
OQ-E8-1: Stripe Configuration
What is the Stripe account configuration (test/live keys, webhook URLs)?
Blocking: Cannot proceed without credentials.
OQ-E8-2: E-Racuni API
What are the e-racuni API authentication and endpoint details?
Blocking: Cannot proceed without API access.
Related Documentation¶
Last Updated: January 2026