Integração Nayax → Saipos¶

Sobre esta documentação¶

Esta documentação cobre a integração completa entre o sistema de pagamentos Nayax e o sistema POS Saipos. O sistema recebe eventos de transações do Nayax via webhook e os processa de forma assíncrona, enviando-os para o Saipos.

Arquitetura¶

graph LR
    A[Nayax] -->|Webhook| B[NayaxController]
    B --> C[NayaxAuthGuard]
    C --> D[NayaxService]
    D --> E[(Database)]
    E --> F[JobsProcessor]
    F --> G[Mapper]
    G --> H[SaiposClient]
    H --> I[Saipos API]

Características Principais¶

• ✅ Processamento Assíncrono - Outbox pattern para confiabilidade
• ✅ Retry Inteligente - Backoff exponencial com jitter
• ✅ Multi-tenancy - Suporte a múltiplos restaurantes
• ✅ Autenticação Flexível - JWT, Bearer Token, Basic Auth
• ✅ Sistema de Permissões - Roles hierárquicos (OWNER → VIEWER)
• ✅ Monitoramento - Logs detalhados e métricas em tempo real

Tecnologias¶

• Backend: NestJS + TypeScript
• Database: PostgreSQL + Prisma ORM
• Autenticação: JWT + bcrypt
• Jobs: Cron-based processor
• Documentação: MkDocs Material

Links Rápidos¶

• Visão Geral da Arquitetura
• Configuração de Ambiente
• Problemas Comuns
• Glossário