DocsFAQ e Risoluzione Problemi
Domande frequenti e suggerimenti per la risoluzione dei problemi
1. Ricevo un errore "Unauthorized"
Questo di solito significa che stai inviando una chiave API errata o scritta male. Verifica che la tua chiave sia corretta e che sia formattata correttamente nell'header Authorization.
Esempio di risposta con autenticazione fallita:
{
"error": "werkzeug.exceptions.Unauthorized",
"message": "The server could not verify that you are authorized to access the URL requested."
}Assicurati di includere i due punti finali dopo la tua chiave API quando utilizzi l'Autenticazione Base (es. YOUR_API_KEY:). I due punti separano il nome utente dalla password vuota.
2. Ricevo un errore "Unsupported payment method"
Ogni metodo di pagamento deve essere attivato sul tuo account prima di poter essere utilizzato. Se tenti di usare un metodo inattivo, l'API restituisce un 400 Bad Request:
{
"error": "werkzeug.exceptions.BadRequest",
"message": "The requested payment method is not active for this merchant."
}Contatta il tuo account manager Cost+ o abilita il metodo di pagamento nel portale di amministrazione sotto Impostazioni > Metodi di Pagamento.
3. Quali numeri di carte di test posso utilizzare?
Consulta la pagina Testare l'Integrazione per un elenco completo dei numeri di carte di test, incluse le carte che simulano transazioni riuscite e fallite.
4. Come vengono gestiti i tentativi di consegna dei webhook?
Se il tuo endpoint webhook non risponde con un codice di stato 2xx, Cost+ ritenterà la consegna:
- Fino a 10 tentativi, distanziati di 2 minuti.
- Il primo tentativo va in timeout dopo 4 secondi.
- I tentativi successivi vanno in timeout dopo 10 secondi.
Se tutti i 10 tentativi falliscono, l'evento webhook viene contrassegnato come fallito e non verrà ritentato. Assicurati che il tuo endpoint risponda rapidamente e restituisca un codice di stato 200.
Per i dettagli completi sulla configurazione dei webhook e i formati dei payload, consulta la guida Webhook.