DocsTestare l'Integrazione
Configura il tuo ambiente di test e utilizza le credenziali di test
Prima di andare in produzione, utilizza un sito web sandbox Cost+ per verificare che la tua integrazione funzioni correttamente. Non esiste un URL sandbox separato — utilizzi lo stesso endpoint API di produzione (https://api.costplus.online/v1) con una chiave API da un sito web sandbox.
Ottenere la Chiave API di Test
- Accedi al Portale Commerciante
- Vai a Siti Web
- Crea un nuovo sito web e seleziona Sandbox come tipo, oppure seleziona un sito web sandbox esistente
- Clicca su Integrazione per trovare la tua chiave API
- Usa questa chiave API nella tua integrazione — tutte le transazioni saranno simulate
La modalità sandbox rispetto alla produzione è determinata interamente dal tipo di sito web nel Portale Commerciante, non dall'URL dell'API. La chiave API di un sito web sandbox elabora transazioni simulate; la chiave API di un sito web di produzione elabora pagamenti reali. Entrambi utilizzano lo stesso endpoint API.
Numeri di Carte di Test
Utilizza i numeri di carta seguenti per simulare diversi scenari di pagamento. Non utilizzare numeri di carta reali in modalità test.
| Numero Carta | CVV | Circuito | Risultato |
|---|---|---|---|
4111111111111111 | qualsiasi | Visa | Successo |
5544330000000037 | qualsiasi | Mastercard | Successo |
4462030000000000 | qualsiasi | Visa | Successo |
4111111111111105 | qualsiasi | Visa | Do Not Honor |
4111111111111143 | qualsiasi | Visa | Stolen Card |
4111111111111151 | qualsiasi | Visa | Insufficient Funds |
Utilizza qualsiasi data di scadenza futura e qualsiasi CVC a 3 cifre.
I numeri di carte di test funzionano solo in modalità sandbox. Inviarli alla chiave API di un sito web di produzione risulterà in una transazione rifiutata.
Codici di Errore
Quando una transazione fallisce, l'API restituisce uno dei seguenti codici di errore nel campo reason della transazione:
| Codice Errore | Descrizione |
|---|---|
ERROR_CARD_AUTHENTICATION_FAILURE | Autenticazione 3DS non completata in tempo; pagamento annullato |
ERROR_CARD_CVV_NOT_VALID | CVV formattato correttamente ma non valido |
ERROR_CARD_INFORMATION_NOT_VALID | Dati carta formattati correttamente ma non validi |
ERROR_CARD_NOT_SUPPORTED_FOR_ECOMMERCE | Transazione non supportata per l'eCommerce |
ERROR_CARD_NOT_VALID | ID carta non valido |
ERROR_CARD_TYPE_DISABLED | Tipo di carta disabilitato |
ERROR_TRANSACTION_FAILED | Transazione con carta fallita |
ERROR_TRANSACTION_REJECTED_BY_CARD_PROCESSOR | Rifiutata dal processore (include codice numerico Visa/MC) |
ERROR_TRANSACTION_TYPE_NOT_ALLOWED_BY_SELLER | Tipo di transazione non consentito dal venditore |
ERROR_TRANSACTION_TYPE_NOT_SUPPORTED | Non supportato dal circuito |
INVALID_CARD_CVV | CVV non riconosciuto |
INVALID_CARD_NUMBER | Numero carta non riconosciuto |
Errori di Validazione API Comuni
Questi errori vengono restituiti come 400 Bad Request quando la richiesta API stessa non è valida:
| Errore | Descrizione |
|---|---|
| Unknown payment method | Hai fornito un nome di metodo di pagamento errato |
| No permissions for payment method | La tua chiave API (progetto) non ha i permessi per il metodo di pagamento specificato |
| Payment method not enabled | Il metodo di pagamento non è stato abilitato per la tua chiave API (progetto) |
| Payment method not supported | La tua chiave API (progetto) non ha lo stato corretto per utilizzare il metodo di pagamento specificato |
Se ricevi "Payment method not enabled" o "No permissions", verifica la configurazione del metodo di pagamento nel Portale Commerciante nelle impostazioni del tuo sito web.