API
Autenticação
Como autenticar suas chamadas à API BuckPay usando Bearer token e user-agent.
Autenticação
Todas as requisições à API BuckPay devem incluir autenticação via header Authorization.
Header Authorization
Envie o token no formato:
Authorization: Bearer <token>O <token> é um secret de 40 caracteres fornecido pelo BuckPay. Solicite suas credenciais ao seu gerente de contas.
User-Agent
Atenção: Para que sua chamada seja aceita, é necessário também enviar o header user-agent conforme orientado pelo seu gerente de contas. Sem o user-agent correto, a requisição pode falhar.
Exemplo de requisição autenticada:
curl -X POST "https://api.realtechdev.com.br/api/transactions" \
-H "Authorization: Bearer SEU_TOKEN_40_CARACTERES" \
-H "User-Agent: <valor fornecido pelo gerente>" \
-H "Content-Type: application/json" \
-d '{"external_id":"pedido-123","payment_method":"pix","amount":3590,"buyer":{"name":"João Silva","email":"joao@email.com"}}'Respostas de erro de autenticação
Se o token estiver ausente, inválido ou expirado, a API retorna 401 Unauthorized:
| Situação | Resposta |
|---|---|
Header Authorization ausente | "detail": "Authorization header is required." |
| Formato inválido ou token ausente | "detail": "Invalid authorization header format or missing token." |
| Token com tamanho diferente de 40 caracteres | "detail": "Invalid authorization token." |
| Token não encontrado ou revogado | "detail": "Invalid authorization token." |
Exemplo de corpo de resposta 401:
{
"error": {
"message": "Unauthorized.",
"detail": "Invalid authorization token."
}
}