Annuler une carte

Utilisez la requête API Cards Cancel d'Affirm pour annuler entièrement une carte virtuelle.

📘

Activation de la fonctionnalité

Veuillez contacter votre contact technique si vous souhaitez que cette fonctionnalité soit activée.

How It Works

The Cards Cancel API allows merchants to immediately void and/or cancel the Affirm virtual card (and loan) by supplying a valid checkout_id. Please use this tool carefully. We normally see the usage of this API request for a business model where:

  • De nombreux changements de prix (vols, marchandises, enchères, etc.) où la commande n'a pas été confirmée avec succès.
  • Si vous rencontrez de nombreux échecs de commande.
📘

Soutien

Si vous n'êtes pas certain que cela s'applique à votre entreprise, veuillez nous contacter via le widget d'assistance.

❗️

Important

L'API d'annulation ne doit pas être utilisée après l'exécution de la commande et/ou lorsque la carte sera capturée, car il peut y avoir des cas où
(a) les frais sont perçus selon les modalités et conditions de l'achat
(b) la partie de l'achat n'est pas remboursable
(c) le commerçant a ou va effectuer une capture sur la carte et n'émettra pas de remboursement complet

Calendrier

Sur autorisation

Lors de la capture

👍

Réponse réussie

À la réception de la confirmation, le prêt du client sera annulé ou entièrement remboursé.Cette annulation supprimera aussi le prêt de son espace client Affirm.

  • Si la carte est expirée, annulée ou auth_expired, rien ne se passe car la carte est déjà annulée.
  • If the card is in a confirmed state, Affirm expires the card, and cancels the charge.
  • Si la carte est dans un état autorisé, Affirm expirera l’autorisation de la carte et annulera les frais.
  • Si la carte est dans un état capturé, Affirm expirera l'autorisation de la carte et annulera le prêt. Affirm s'attend à ce que le commerçant rembourse intégralement les frais si un événement de capture a été soumis avec succès.
❗️

Mauvaise requête

  • Le commerçant n’est pas un commerçant Platforms VCN.
  • There is no checkout_id with that checkout_id.
  • There is no card associated with the checkout_id.
  • L'agent actuel n'a pas l'autorisation de mettre à jour la charge (commerçant incorrect).
  • La contestation de la charge est en cours.
  • The card state is not being handled (should never happen unless we add a new CardState).
❗️

Environnement de production

Ces requêtes incorrectes ne sont reproductibles que dans un environnement de production, car les détails réels des cartes ne sont pas générés dans l'environnement de test.