Refus de paiement

Les paiements peuvent échouer pour diverses raisons, et parfois pour éviter les transactions frauduleuses. Stripe s’efforce de réduire les taux de refus pour tous les moyens de paiement pris en charge. Nous collaborons avec les émetteurs et les réseaux pour améliorer les taux d’acceptation, souvent sans affecter votre intégration.

Un paiement peut échouer pour trois raisons :

• Refus par l’émetteur
• Paiements bloqués
• Appels à l’API non valides

Vous devez gérer différemment chaque type d’échec de paiement. Pour chaque échec, utilisez le Dashboard ou l’API afin de consulter les détails d’un paiement. Lorsque vous utilisez l’API, examinez le résultat de l’objet Charge. Cet attribut fournit des informations sur le type et le motif d’échec du paiement.

Stripe traite les refus de paiement non effectués par carte bancaire de la même manière que les refus de paiement par carte bancaire. Stripe vous envoie un code de réponse contenant des informations sur le refus de paiement, par exemple s’il est dû à des fonds insuffisants, à une carte perdue ou volée, ou à toute autre raison.

Refus par l’émetteur

Lorsque l’émetteur de la carte de votre client ou le prestataire de services de paiement reçoit un paiement, ses systèmes et modèles automatisés décident s’il faut l’autoriser. Ces outils analysent des signaux tels que les habitudes de dépenses, le solde du compte et les données de la carte bancaire (date d’expiration, informations d’adresse et CVC).

Si l’émetteur de la carte ou le prestataire de services de paiement refuse un paiement, Stripe partage avec vous les informations de refus que nous recevons via les codes de refus de Stripe. Ces informations sont disponibles dans le Dashboard et via l’API. Lorsque les émetteurs fournissent des explications spécifiques, telles qu’un numéro de carte incorrect ou des fonds insuffisants, ces explications reviennent à Stripe sous forme de codes de refus réseau.

Paiements bloqués

Stripe Radar bloque les paiements à haut risque, tels que ceux dont le CVC ou le code postal ne correspond pas. Cet outil automatisé de prévention de la fraude évalue chaque paiement, sans intervention nécessaire de votre part.

Lorsque Stripe bloque un paiement, elle n’obtient pas l’autorisation de l’émetteur de la carte. Cette précaution permet d’éviter d’éventuels paiements frauduleux pouvant donner lieu à des litiges.

Pour certains types de carte, l’autorisation de l’émetteur de la carte (du montant du paiement) peut apparaître sur le relevé des clients. Cependant, Stripe n’a pas débité ce montant ni retiré les fonds. L’émetteur de la carte supprime généralement cette autorisation du relevé du client au bout de quelques jours.

Si une règle que vous avez configurée bloque un paiement que vous reconnaissez comme légitime, vous pouvez lever le blocage en localisant le paiement dans le Dashboard et en cliquant sur Ajouter à la liste blanche. Cette action ne permet pas de relancer le paiement. En revanche, toutes vos autres règles autoriseront alors les tentatives de paiement ultérieures qui correspondent à l’attribut de la liste.

Lorsque vous utilisez l’API, le outcome d’un paiement bloqué reflète le type d’échec de paiement et la raison de l’échec de paiement, ainsi que le niveau de risque évalué.

...
outcome: {
  network_decline_code: null,
  network_advice_code: null,
  network_status: "not_sent_to_network",
  reason: "highest_risk_level",
  advice_code: "do_not_try_again",
  risk_level: "highest",
  seller_message: "Stripe blocked this charge as too risky.",
  type: "blocked"
},
...

Pour les utilisateurs bénéficiant de la tarification IC+, Adaptive Acceptance bloque certains paiements afin de vous éviter des coûts de réseau inutiles. Par exemple, Adaptive Acceptance vous permet d’éviter des pénalités excessives pour les relances. Adaptive Acceptance peut également vous aider à éviter des coûts de réseau en bloquant les paiements qui ont une faible probabilité d’autorisation.

...
outcome: {
  network_decline_code: null,
  network_advice_code: null,
  network_status: "not_sent_to_network",
  reason: "low_probability_of_authorization",
  advice_code: "do_not_try_again",
  risk_level: "normal",
  seller_message: "Stripe blocked this payment as it is unlikely to be authorized.",
  type: "blocked"
},
...

Appels à l’API non valides

L’API peut afficher un appel à l’API non valide comme celui-ci :

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=2000 \
  -d currency=usd \
  -d payment_method=pm_card_chargeDeclinedIncorrectCvc \
  -d confirm=true

L’appel à l’API non valide génère une réponse d’erreur de la forme suivante :

{
  "error": {
    "code": "incorrect_cvc",
    "doc_url": "https://stripe.com/docs/error-codes/incorrect-cvc",
    "message": "Your card's security code is incorrect.",
    "param": "cvc",
    "type": "card_error"
  }
}

Le résultat d’un paiement refusé inclut le type d’échec de paiement et le motif, en fonction du code de refus du réseau de cartes. Le motif peut contenir d’autres informations que le code de réponse du réseau de cartes bancaires, par exemple lorsqu’une évaluation de règle Radar a bloqué le paiement.

...
outcome: {
  network_decline_code: "54",
  network_advice_code: "03",
  network_status: "declined_by_network",
  reason: "expired_card",
  advice_code: "confirm_card_data",
  risk_level: "normal",
  seller_message: "The bank returned the decline code `expired_card`.",
  type: "issuer_declined"
},
...

Au fil du développement de votre intégration Stripe, testez-la en permanence pour identifier tout bogue potentiel susceptible de conduire à des appels à l’API non valides. En cas d’appel à l’API non valide, vous ne verrez habituellement pas de paiement apparaître dans votre Dashboard. Cependant, dans certains cas, le paiement sera visible.

...
outcome: {
  network_decline_code: null,
  network_advice_code: null,
  network_status: "not_sent_to_network",
  type: "invalid"
},
...