DocsTester votre intégration
Configurez votre environnement de test et utilisez les identifiants de test
Avant de passer en production, utilisez un site web sandbox Cost+ pour vérifier que votre intégration fonctionne correctement. Il n'existe pas d'URL sandbox séparée — vous utilisez le même point d'accès API de production (https://api.costplus.online/v1) avec une clé API provenant d'un site web sandbox.
Obtenir votre clé API de test
- Connectez-vous au Portail marchand
- Accédez à Sites web
- Créez un nouveau site web et sélectionnez Sandbox comme type, ou sélectionnez un site web sandbox existant
- Cliquez sur Intégration pour trouver votre clé API
- Utilisez cette clé API dans votre intégration — toutes les transactions seront simulées
Le mode sandbox ou production est déterminé entièrement par le type de site web dans le Portail marchand, et non par l'URL de l'API. La clé API d'un site web sandbox traite des transactions simulées ; la clé API d'un site web de production traite des paiements réels. Les deux utilisent le même point d'accès API.
Numéros de cartes de test
Utilisez les numéros de cartes ci-dessous pour simuler différents scénarios de paiement. N'utilisez pas de vrais numéros de carte en mode test.
| Numéro de carte | CVV | Marque | Résultat |
|---|---|---|---|
4111111111111111 | quelconque | Visa | Succès |
5544330000000037 | quelconque | Mastercard | Succès |
4462030000000000 | quelconque | Visa | Succès |
4111111111111105 | quelconque | Visa | Refusée (Do Not Honor) |
4111111111111143 | quelconque | Visa | Carte volée (Stolen Card) |
4111111111111151 | quelconque | Visa | Fonds insuffisants |
Utilisez n'importe quelle date d'expiration future et n'importe quel CVC à 3 chiffres.
Les numéros de cartes de test ne fonctionnent qu'en mode sandbox. Les soumettre avec la clé API d'un site web de production entraînera une transaction refusée.
Codes d'erreur
Lorsqu'une transaction échoue, l'API renvoie l'un des codes d'erreur suivants dans le champ reason de la transaction :
| Code d'erreur | Description |
|---|---|
ERROR_CARD_AUTHENTICATION_FAILURE | Authentification 3DS non finalisée à temps ; paiement annulé |
ERROR_CARD_CVV_NOT_VALID | CVV correctement formaté mais non valide |
ERROR_CARD_INFORMATION_NOT_VALID | Informations de carte correctement formatées mais non valides |
ERROR_CARD_NOT_SUPPORTED_FOR_ECOMMERCE | Transaction non prise en charge pour le e-commerce |
ERROR_CARD_NOT_VALID | Identifiant de carte non valide |
ERROR_CARD_TYPE_DISABLED | Type de carte désactivé |
ERROR_TRANSACTION_FAILED | Échec de la transaction par carte |
ERROR_TRANSACTION_REJECTED_BY_CARD_PROCESSOR | Rejetée par le processeur (inclut le code numérique Visa/MC) |
ERROR_TRANSACTION_TYPE_NOT_ALLOWED_BY_SELLER | Type de transaction non autorisé par le vendeur |
ERROR_TRANSACTION_TYPE_NOT_SUPPORTED | Non pris en charge par le réseau de cartes |
INVALID_CARD_CVV | CVV non reconnu |
INVALID_CARD_NUMBER | Numéro de carte non reconnu |
Erreurs courantes de validation API
Ces erreurs sont renvoyées en tant que 400 Bad Request lorsque la requête API elle-même est invalide :
| Erreur | Description |
|---|---|
| Unknown payment method | Vous avez fourni un nom de méthode de paiement incorrect |
| No permissions for payment method | Votre clé API (projet) n'a pas les permissions pour la méthode de paiement spécifiée |
| Payment method not enabled | La méthode de paiement n'a pas été activée pour votre clé API (projet) |
| Payment method not supported | Votre clé API (projet) n'a pas le statut requis pour utiliser la méthode de paiement spécifiée |
Si vous recevez "Payment method not enabled" ou "No permissions", vérifiez la configuration de la méthode de paiement dans le Portail marchand sous les paramètres de votre site web.