NamePayment ServiceTypeEXTERNAL_APICategorySHAREDVersion1.0.0DescriptionIntegração com o provedor de pagamentos Stripe para o marketplace INNK: criação/confirmação de cobranças (PaymentIntents), assinaturas (Billing), reembolsos e repasses/payouts (Connect), além do recebimento/validação de webhooks para reconciliação assíncrona.
Escopo (o que ESTE sistema cobre):
- Superfície externa: endpoints REST / métodos SDK da Stripe e webhooks recebidos.
- Autenticação/segurança de integração (API key e validação de assinatura de webhook).
- Resiliência: rate limits, retries com backoff+jitter, circuit breaker e fallbacks quando a Stripe estiver indisponível.
Fora de escopo (responsabilidade de serviços internos como Booking Service/Admin/Analytics e do banco):
- Cálculo de comissão/taxas e regras de negócio.
- Persistência, reconciliação contábil completa e auditoria.
- Modelagem de estados do domínio (booking/subscription) e autorização do usuário final.
Dependência crítica: todo fluxo deve tolerar indisponibilidade do provedor, degradando com estado PENDING e reconciliação via webhooks.