Portal de integração
Integrações CashPay
Contratos oficiais para empresas gerarem ordens e aplicativos parceiros autorizarem colaboradores e efetuarem pagamentos.
URL base da API
https://www.touchpay-dev.com.br/apiAnexe os caminhos abaixo sem repetir /api. Utilize HTTPS em todos os ambientes.
Dois níveis de acesso
role empresa-ordem-venda
role parceiro-pagamento
Integração servidor a servidor
Troque as credenciais por um JWT válido por 24 horas.
Carregue a coleção quando a venda utilizar recorrência.
Receba o QR Code, o pedido e o código da operação.
Consulte o pagamento a cada 3–5 segundos até a conclusão.
Ordens e pagamentos
Autenticação, criação de ordens, polling e produtos recorrentes.
Autenticação e token de acesso
Não requer autenticação. Retorna um JWT com a role empresa-ordem-venda e validade de 24 horas.
https://www.touchpay-dev.com.br/api/integracoes/v1/empresas/auth/token{
"clientId": "CLIENT_ID_DA_EMPRESA",
"clientSecret": "CLIENT_SECRET_DA_EMPRESA"
}- O clientSecret deve permanecer no backend e nunca ser exposto em navegador, aplicativo, logs ou repositório.
Códigos HTTP
Operação concluída.
Payload inválido, pedido não localizado ou regra de negócio não atendida.
Credenciais ou token ausente, inválido ou expirado.
Acesso sem a autorização necessária.
Serviço de ordens temporariamente indisponível.