API
Pular para o conteúdo principal

Início

O Terminal Cloud é uma solução avançada que permite integração completa entre o terminal de pagamento e o sistema do cliente através de API REST, possibilitando automação e controlo remoto das transações.

Arquitetura da Integração

┌─────────────────┐      API REST       ┌──────────────────┐
│  Seu Sistema    │ ←─────────────────→ │   API PayPay     │
│  (POS/ERP)      │                     │                  │
└─────────────────┘                     └──────────────────┘
      ↑                                        ↓
      │                                   ┌────────────┐
      │          Webhook                  │  Terminal  │
      └───────────────────────────────────┤   Cloud    │
               (notificação)              └────────────┘
                                                 ↕
                                          ┌──────────────┐
                                          │    Rede de   │
                                          │  Pagamentos  │
                                          └──────────────┘

Resolução de Problemas Comuns

ProblemaCausa ProvávelSolução
Terminal não respondeTerminal offline ou UUID incorretoVerificar conexão e UUID do Terminal
Webhook não recebidoEndpoint não configurado ou inacessívelVerificar URL e firewall
Transação recusadaVerificar fundos, validade do cartão ou contactar banco emissor
Terminal não respondeVerificar conexão à internet e reiniciar terminal
Erro na impressãoVerificar papel e configurações de impressão
PIN incorretoCliente pode tentar novamente (máximo 3 tentativas)

Próximos Passos

Explore a documentação completa para integração: