Integrações
Seu sistema faz uma solicitação pela API. Um webhook informa o que mudou. Um app amplia a rotina do seller. A adquirência processa o pagamento. Entenda como essas peças trabalham juntas.
Uma integração de negócio e uma conexão com um processador resolvem problemas diferentes — e podem fazer parte da mesma operação.
01
ERP, plataforma de vendas ou serviço interno: a API permite executar ações e consultar recursos autorizados. Os webhooks levam as mudanças de estado ao seu backend para alimentar os próximos passos.
Representação conceitual de sistemas próprios e responsabilidades; não é um catálogo de integrações homologadas.
02
A conexão com processadores pertence à camada de pagamentos. Meios, funcionalidades e rotas elegíveis dependem do parceiro e da configuração habilitada no gateway; não são apps instalados pelo seller.
Conhecer a multiadquirência
Ilustração conceitual: marcas e rotas representadas não confirmam disponibilidade ou homologação de parceiros.
O contrato da API define recursos, permissões e operações por escopo. O acesso do gateway administra sua operação; o do seller atua nos recursos autorizados da própria conta.
01 / Pessoas e painéis
Nos painéis, a sessão identifica o usuário, seu contexto e suas permissões. O fluxo de login, renovação e autenticação em dois fatores pertence a essa experiência — não deve ser substituído pelo compartilhamento de uma chave secreta.
02 / Sistemas próprios
No backend da integração, use uma chave com apenas os scopes necessários. Guarde o segredo em ambiente protegido, nunca no navegador. Separe chaves por serviço para poder revogar ou rotacionar um acesso sem compartilhar credenciais.
Mudanças de pagamento e outros eventos assinados permitem conectar a operação aos seus processos, sem depender de consultas contínuas para descobrir cada atualização.
01
Você configura o destino e os eventos relevantes. A Paragan envia a notificação; seu backend valida a origem e decide qual processo executar.
Fluxo conceitual; eventos, recursos e capacidades dependem do contrato e da configuração da operação.
01
Confira a assinatura HMAC sobre o corpo original e o timestamp. Registre o evento com segurança antes de confirmar o recebimento e processar a ação.
02
Identifique repetições pelo identificador do evento e torne a ação idempotente. Uma nova entrega não significa um novo negócio, e a ordem de chegada não é garantida.
03
Tentativas, histórico de entregas e reenvio ajudam a investigar falhas. A rotação do segredo faz parte da manutenção do receptor.
O catálogo reúne extensões com finalidade e permissões definidas. O seller escolhe o que faz sentido para sua rotina e mantém o controle sobre os acessos concedidos.
01
O seller consulta os apps disponíveis, revisa as permissões solicitadas e autoriza a instalação. Pode desinstalar a extensão quando ela deixar de fazer parte da operação.
Ver a experiência de checkoutRepresentação conceitual de permissões e extensões; não apresenta um catálogo de parceiros homologados.
01
Consulte a finalidade, a versão e as permissões de cada app disponível. Uma atualização que solicite novos acessos exige revisar o consentimento antes de continuar.
02
Se a rotina exige regras específicas do seu sistema, combine API e eventos. A lógica da automação fica no serviço que recebe e processa essas informações.
Filas e processamento assíncrono fazem parte da arquitetura. Na integração, planeje também o que acontece quando uma resposta demora, um evento se repete ou um serviço fica indisponível.
Mapeie quem executa cada ação, os recursos necessários e as permissões mínimas. Confirme os meios e parceiros habilitados para o projeto.
Nas mutações que exigem idempotência, use uma chave por operação lógica e mantenha a mesma chave e o mesmo conteúdo nas retentativas.
Diferencie falha de validação, permissão e indisponibilidade. Respeite os limites de chamadas e o intervalo informado ao receber uma resposta 429.
Correlacione recursos e eventos, registre o identificador da requisição nos erros e acompanhe as entregas. Não grave segredos nos logs.
Não necessariamente. Os painéis e o checkout atendem às rotinas do produto. Apps disponíveis podem ampliar usos específicos. A integração própria entra quando outro sistema precisa executar ações ou receber informações automaticamente.