Codes d’erreur

L'objet d'erreurInterroger Athia à ce sujet#

{
  "error": {
    "code": "PAYMENT_DECLINED",
    "message": "The payment was declined by the payment provider.",
    "decline_reason": "insufficient_funds",
    "request_id": "req_7Hc2LqP",
    "doc_url": "/errors#payment-declined"
  }
}

• code — identifiant stable sur lequel bifurquer.
• message — lisible par l'homme, peut changer. Ne l'analysez pas.
• request_id - incluez-le lorsque vous contactez le support.

Référence d'erreurInterroger Athia à ce sujet#

{
  "error": {
    "code": "PAYMENT_DECLINED",
    "decline_reason": "insufficient_funds",
    "request_id": "req_7Hc2LqP"
  }
}

{
  "error": {
    "code": "CARD_EXPIRED",
    "request_id": "req_2Pb8XwQ"
  }
}

{
  "error": {
    "code": "INVALID_REQUEST",
    "param": "amount",
    "message": "amount must be an integer."
  }
}

{
  "error": {
    "code": "AUTHENTICATION_FAILED",
    "request_id": "req_9Qd1MnZ"
  }
}

{
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "param": "id"
  }
}

{
  "error": {
    "code": "IDEMPOTENCY_CONFLICT",
    "request_id": "req_4Tr6VbS"
  }
}

{
  "error": "rate_limit_exceeded",
  "message": "maximum requests",
  "code": 429,
  "endpoint": "/merchants/orders",
  "total_requests": 101,
  "retry_after": "1s"
}

{
  "error": {
    "code": "PROVIDER_UNAVAILABLE",
    "routing": { "attempts": 2 }
  }
}

Catalogue des erreurs de paiement et de commandeInterroger Athia à ce sujet#

Ce catalogue restaure l'ensemble complet de codes stables provenant de la référence de codes de réponse publique précédente. Les codes actuels ont été vérifiés par rapport aux chemins de code des API de paiement et de commande ; les codes réservés aux anciens systèmes restent listés pour la compatibilité ascendante. Les messages peuvent varier ; opérez sur le code plutôt que de parser le texte du message.

Commandes et caisse

Cycle de vie de la commande, préparation de la caisse, liens de paiement, gestion des fichiers et des requêtes.

Paiements

Validation, traitement, authentification des transactions et réponses des fournisseurs.

Réponses de commande du commerçant

Erreurs renvoyées lors de la validation des réponses de commande, de fulfillment et de coupon du commerçant.

Prévention de la fraude

Des erreurs de fraude stables sont renvoyées lors des opérations de paiement et de commande.

Gestion des erreursInterroger Athia à ce sujet#

1. Branche sur error.code; journal request_id.
2. Réessayer 5xx et 429 avec recul et pareil Idempotency-Key.
3. Ne réessayez jamais 400, 401 ou 402 unchanged.