Bem-vindo à documentação da API RelaxPay v2! Esta versão utiliza autenticação via Bearer token, proporcionando uma camada adicional de segurança e flexibilidade para sua integração.

​
Visão Geral da API v2

A API v2 do RelaxPay oferece uma solução completa para integração de pagamentos PIX em suas aplicações, com autenticação via Bearer token. Todos os endpoints começam com o prefixo /api/v2/gateway/.

Autenticação Bearer

Use seu Client Secret como Bearer token:

Authorization: Bearer seu-client-secret

Segurança Avançada

Método padronizado de autenticação seguindo boas práticas de segurança

​
Recursos Disponíveis

PIX Cash-in

Receba pagamentos via PIX:

  • Geração de QR Code dinâmico
  • Confirmação automática de pagamentos
  • Notificações em tempo real

PIX Cash-out

Envie pagamentos via PIX:

  • Transferências instantâneas
  • Validação de chaves PIX
  • Controle de duplicidade

​
Processo de Autenticação

Obtenha suas Credenciais

Acesse o Dashboard RelaxPay e obtenha seu Client ID e Client Secret

Use o Client Secret como Bearer Token

Inclua seu Client Secret como token no header de autorização em todas as requisições:

Authorization: Bearer seu-client-secret

​
Exemplo de Integração

​
Fluxo de Integração

Obtenha suas Credenciais

Acesse o Dashboard RelaxPay e obtenha seu Client ID e Client Secret

Implemente a Autenticação

Use seu Client Secret como Bearer token no header Authorization de suas requisições

Configure os Webhooks

Implemente um endpoint para receber notificações automáticas sobre o status das transações

Teste sua Integração

Utilize o ambiente de sandbox para validar sua implementação antes de ir para produção

​
Próximos Passos

Autenticação

Saiba mais sobre o processo de autenticação

Referência da API

Explore todos os endpoints disponíveis

Webhooks

Configure notificações em tempo real

Se você prefere uma autenticação via headers, também oferecemos a API v1, que utiliza autenticação via headers ci e cs.