DocsFAQ e Resolução de Problemas
Perguntas frequentes e dicas de resolução de problemas
1. Estou a receber um erro "Unauthorized"
Isto geralmente significa que está a enviar uma chave API incorreta ou com erros de escrita. Verifique que a sua chave está correta e que está devidamente formatada no cabeçalho Authorization.
Exemplo de uma resposta de autenticação falhada:
{
"error": "werkzeug.exceptions.Unauthorized",
"message": "The server could not verify that you are authorized to access the URL requested."
}Certifique-se de que inclui os dois pontos após a sua chave API ao utilizar Autenticação Básica (por exemplo, YOUR_API_KEY:). Os dois pontos separam o nome de utilizador da palavra-passe vazia.
2. Estou a receber um erro "Unsupported payment method"
Cada método de pagamento deve ser ativado na sua conta antes de poder ser utilizado. Se tentar utilizar um método inativo, a API devolve um 400 Bad Request:
{
"error": "werkzeug.exceptions.BadRequest",
"message": "The requested payment method is not active for this merchant."
}Contacte o seu gestor de conta Cost+ ou ative o método de pagamento no portal de administração em Definições > Métodos de Pagamento.
3. Que números de cartão de teste posso utilizar?
Consulte a página Testar a Sua Integração para uma lista completa de números de cartão de teste, incluindo cartões que simulam transações bem-sucedidas e falhadas.
4. Como são tratadas as tentativas de reenvio de webhooks?
Se o seu endpoint de webhook não responder com um código de estado 2xx, a Cost+ tentará reenviar:
- Até 10 tentativas, com intervalos de 2 minutos.
- A primeira tentativa expira após 4 segundos.
- As tentativas subsequentes expiram após 10 segundos.
Se todas as 10 tentativas falharem, o evento de webhook é marcado como falhado e não será tentado novamente. Certifique-se de que o seu endpoint responde rapidamente e devolve um código de estado 200.
Para detalhes completos sobre configuração de webhooks e formatos de payload, consulte o guia de Webhooks.