Sponsorship: Stripe webhooks, invoice mirroring, Brevo receipts (Phase 7.3, 7.4)
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 5/5
- Tiempo estimado
- Más de una semana
- Aptitud para principiantes
- 32/100
Línea de trabajo
Empieza revisando el contrato de metadatos en #14 y #15, y sigue después el patrón existente de restricciones únicas de los webhooks de GitHub. Implementa y prueba POST /webhooks/stripe, incluido el manejo de firmas, el orden del ciclo de vida, la idempotencia y el comportamiento best-effort de IEmailSender. Añade cobertura de xUnit en tests/CommunityPro.Tests// siguiendo el patrón de MembersTestHarness.cs; se considera terminado cuando se cumplen todos los criterios de aceptación enumerados.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Scope
POST /webhooks/stripe — signature-verified, idempotent, drives the sponsor lifecycle and local invoice mirror.
Events
| Event | Action |
|---|---|
checkout.session.completed |
create/activate Sponsor from session metadata + customer/subscription ids |
invoice.paid |
upsert SponsorInvoice (amount, hosted URL, PDF); relay branded receipt/thank-you via Brevo incl. customer-portal link |
invoice.payment_failed |
upsert invoice as failed; sponsor → PastDue |
customer.subscription.updated / deleted |
sync SponsorStatus (Active/PastDue/Cancelled) |
Rules
- Verify
Stripe-Signatureagainst the webhook secret on the raw request body. - Idempotent by Stripe event id — same unique-constraint-insert pattern as the GitHub webhooks (Stripe retries for days). Unhandled event types → 200 no-op.
- Rely on Stripe Invoicing natively (subscriptions generate invoices; PDFs/emails enabled in Stripe settings) — local rows exist purely for the admin dashboard.
- Brevo sends best-effort via
IEmailSender; failures never 500 the webhook (Stripe would retry and duplicate side effects — idempotency guard must cover this).
Error codes
webhooks.invalid_signature (401); everything else 200
Dependencies
Blocked by #14 and #15 (metadata contract).
Acceptance criteria
- Replayed event id → no-op (tested for every handled event type)
- Out-of-order events don't corrupt status (e.g.
subscription.deletedbefore a lateinvoice.paid) - Signature failure → 401 without body processing
- Full lifecycle test: checkout → paid → failed → cancelled
Conventions (project-wide, non-negotiable)
- .NET 9, records for immutable shapes, file-scoped namespaces, primary constructors where they read well. Minimal-API endpoints grouped per module via
IEndpointModule.MapEndpoints. Result<T>(SharedKernel) instead of exception-driven control flow. Endpoint results map failures to ProblemDetails with the stable error codes listed above — the frontend keys off them.- Module owns its EF Core
DbContextmapped to its own Postgres schema. Modules never reference each other's internals — cross-module needs go through a public contract interface or an in-process domain event (IEventPublisher). - All external calls (GitHub, Stripe, Brevo, Cloudinary, Meilisearch) behind interfaces owned by the consuming module.
- Every list endpoint paginated (offset is fine). xUnit tests in
tests/CommunityPro.Tests/<Module>/following the existing harness patterns (seeMembers/MembersTestHarness.cs).
- Lenguaje dominante
- C#
- Estrellas
- 0
- Forks
- 0
- Métricas de merge de PR
- Sin PR fusionados en 30 d
Preparar el entorno
- Incluye un Dockerfile o un archivo de Docker Compose
- Sin plantilla de pull request
- Sin guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de CommunityPro/community-pro-api
-
cross-cutting decision
Dificultad 5/5 Más de una semana Aptitud para principiantes 35/100
-
cross-cutting
Dificultad 4/5 3-5 días Aptitud para principiantes 58/100
-
admin
Dificultad 5/5 Más de una semana Aptitud para principiantes 35/100
-
admin
Dificultad 5/5 Más de una semana Aptitud para principiantes 35/100
-
sponsorship
Dificultad 4/5 3-5 días Aptitud para principiantes 48/100
Todos los issues de CommunityPro/community-pro-api
Issues similares
-
`Source` with an `avares://` URI and a `#fragment` throws instead of scrolling to the anchorAbierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
Kryptos-FR/MarkView.Avalonia#105 ·
Los mantenedores suelen responder en 1 día
-
[辞書]Abierto提案 辞書
Dificultad 2/5 1-3 horas Aptitud para principiantes 65/100
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 76/100
microsoft/fluentui-blazor#5410 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 75/100
Facepunch/sbox-public#12049 ·
Los mantenedores suelen responder en 2 días
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 78/100
EsotericSoftware/spine-runtimes#3185 ·