Introdução ao Gateway de Pagamentos
O gateway de pagamentos da Sopague conecta seu sistema ao processamento de cobranças. Por meio da API, sua aplicação pode criar pagamentos, consultar resultados, receber notificações e gerenciar cancelamentos, mantendo essas operações integradas aos seus pedidos e controles financeiros.
Como funciona
Sua aplicação se autentica na API e envia os dados da cobrança conforme a modalidade escolhida. O gateway processa a solicitação e retorna as informações da transação. Seu sistema guarda os identificadores retornados para consultar o resultado e relacionar cada pagamento ao pedido correspondente.
O cliente paga com cartão, PIX ou pelo checkout de um link de pagamento. Para acompanhar o resultado, sua aplicação consulta a API e, nos fluxos que oferecem callback, recebe notificações por webhook. Com essas informações, você pode atualizar o pedido e dar continuidade ao atendimento no seu sistema.
O que você pode fazer no seu sistema
| Recurso | Como pode ser usado |
|---|---|
| Cartão de débito e crédito | Receber pagamentos no seu checkout e oferecer parcelamento no crédito conforme as condições da integração. |
| PIX | Criar cobranças e apresentar o QR Code ou código copia e cola ao cliente. |
| Link de pagamento | Gerar uma URL de checkout para compartilhar com o cliente. |
| Bibliotecas de segurança | Preparar os dados do cartão e integrar os fluxos de Antifraude ou autenticação 3DS. |
| Consulta de pagamentos | Acompanhar o resultado da transação e atualizar a situação do pedido. |
| Cancelamento e estorno | Cancelar vendas elegíveis no mesmo dia ou solicitar e acompanhar um pedido de estorno. |
| Webhook | Receber notificações de pagamento em um endpoint do seu sistema e automatizar a atualização dos pedidos. |
Consulte os requisitos de cada recurso na documentação específica antes de implementá-lo.
Como começar a integração
- Consulte os ambientes para escolher a URL de homologação ou produção.
- Configure a autenticação do gateway para realizar as chamadas da API pelo seu backend.
- Escolha o fluxo adequado à sua cobrança e valide a integração em homologação.
- Prepare o acompanhamento do resultado por consulta e pelos webhooks disponíveis para o fluxo escolhido.
Em Comece Aqui, você encontra os roteiros resumidos de cartão, PIX, link de pagamento, cancelamento e webhook, com os links para cada etapa.