Erreurs
Introduction
Vérification sans carte présente utilise des codes de réponse HTTP conventionnels pour indiquer le succès ou l'échec d'une requête API.
En règle générale :
- Les codes de la plage 2xx indiquent que la requête a réussi.
- Les codes de la plage 4xx indiquent des paramètres incorrects ou incomplets (par exemple, un paramètre obligatoire a été omis, ou une opération a échoué avec des tiers, etc.).
- Les codes de la plage 5xx indiquent une erreur sur les serveurs du produit Vérification sans carte présente.
Vérification sans carte présente génère également un message d'erreur et un code d'erreur formatés en JSON :
{
"error": {
"code": "40004",
"description": "transaction id is invalid"
}
}
Erreurs possibles
Dans cette rubrique, vous trouverez les erreurs possibles pour les points de terminaison, classées par leur réponse HTTP.
Création de transaction
| Code HTTP | Code | Description | Raison |
|---|---|---|---|
| 400 | 40001 | error decoding json | Les données envoyées ne correspondent pas au contrat de service. |
| 400 | 40002 | error validating json | Certaines informations sont mal formatées ou manquantes. |
| 400 | 40021 | invalid phone | Le numéro de téléphone fourni est invalide, il doit respecter le format : 55 DDD NUMÉRO. Par exemple : 5543999999999. |
| 400 | 40022 | invalid email | L'e-mail fourni est invalide. |
| 400 | 40027 | replicated transaction | La transaction envoyée existe déjà et ne peut pas être créée à nouveau. |
| 400 | 40045 | max value reached | Lorsque la transaction atteint une valeur supérieure à la limite autorisée. |
| 403 | 40301 | not allowed | L'utilisateur n'a pas la permission d'effectuer cette action. |
| 404 | 40404 | company not found | L'entreprise fournie n'existe pas. |
| 429 | 40001 | too many requests | Limite de débit atteinte. |
| 500 | 50001 | internal error | Échec interne du service. |
Obtenir le statut de la transaction
| Code HTTP | Code | Description | Raison |
|---|---|---|---|
| 400 | 40001 | error decoding json | Les données envoyées ne correspondent pas au contrat de service. |
| 400 | 40002 | error validating json | Certaines informations sont mal formatées ou manquantes. |
| 400 | 40004 | transaction id is invalid | L'ID de transaction est invalide (format). |
| 400 | 40301 | not allowed | L'utilisateur n'a pas la permission d'effectuer cette action. |
| 429 | 40401 | transaction not found | La transaction n'a pas été trouvée. |
| 500 | 50001 | internal error | Échec interne du service. |
Récupération du dossier probatoire de la transaction
| Code HTTP | Code | Description | Raison |
|---|---|---|---|
| 400 | 40004 | transaction id is invalid | L'ID de transaction est invalide (format). |
| 400 | 40009 | transaction status is invalid | Le statut de la transaction est invalide (non autorisé pour générer le dossier probatoire). |
| 403 | 40301 | not allowed | L'utilisateur n'a pas la permission d'effectuer cette action. |
| 404 | 40401 | transaction not found | La transaction n'a pas été trouvée. |
| 500 | 50001 | internal error | Échec interne du service. |
Renvoi de la notification de transaction
| Code HTTP | Code | Description | Raison |
|---|---|---|---|
| 400 | 40001 | error decoding json | Les données envoyées ne correspondent pas au contrat de service. |
| 400 | 40002 | error validating json | Certaines informations sont mal formatées ou n'ont pas été renseignées. |
| 400 | 40004 | transaction id is invalid | L'ID de transaction est invalide (format). |
| 400 | 40009 | transaction status is invalid | Le statut de la transaction ne permet pas le renvoi de la notification (elle est déjà terminée). |
| 400 | 40021 | invalid phone | Le numéro de téléphone fourni est invalide, il doit respecter le format : 55 DDD NUMÉRO. Par exemple : 5543999999999. |
| 400 | 40022 | invalid email | L'e-mail fourni est invalide. |
| 403 | 40301 | not allowed | L'utilisateur n'a pas la permission d'effectuer cette action. |
| 404 | 40401 | transaction not found | La transaction n'a pas été trouvée. |
| 429 | 40001 | too many requests | Limite de débit atteinte. |
| 500 | 50001 | internal error | Limite de débit atteinte. |
Intégration de carte de crédit
| Code HTTP | Code | Description | Raison |
|---|---|---|---|
| 400 | 40001 | error decoding json | Les données envoyées ne correspondent pas au contrat de service. |
| 400 | 40002 | error validating json | Certaines informations sont mal formatées ou manquantes. |
| 400 | 40027 | replicated transaction | La transaction soumise existe déjà et ne peut pas être créée à nouveau. |
| 400 | 40030 | invalid identity | Le CPF fourni dans la requête diffère du CPF associé au processID spécifié. |
| 400 | 40045 | max value reached | Lorsque la transaction dépasse le montant autorisé. |
| 400 | 40054 | processID is invalid | Lorsque le processID fourni dans la requête est invalide (ou n'existe pas). |
| 400 | 40055 | processID is expired | Lorsque le processID utilisé est trop ancien. |
| 403 | 40301 | not allowed | L'utilisateur n'a pas la permission d'effectuer cette action. |
| 404 | 40404 | company not found | L'entreprise spécifiée n'existe pas. |
| 404 | 40410 | processID not found | Lorsque le processus spécifié n'existe pas. |
| 404 | 40412 | image not found | Lorsque le processus spécifié par l'utilisateur ne comporte pas d'image. |
| 429 | 40001 | too many requests | Limite de débit atteinte. |
| 429 | 42901 | too many requests | Lorsque le client envoie trop de requêtes, dépassant la limite prédéfinie. |
| 500 | 50001 | internal error | Échec interne du service. |