Annuler une carte

Use Affirm's Card API cancel request to fully void a virtual card.

Comment ça fonctionne

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

  • A large quantity of price changes occur (flights, goods, auctioning, etc.)
  • If you have many order failures

📘

If you are unsure if the specifications listed above apply to your business, please contact us via the support widget.

Calendrier

Review the references below to understand the timelines of Affirm's authorization and capture processes.

On authorization

On capture

👍

Réponse positive

Une fois qu'une réponse de confirmation est reçue, le prêt du client sera annulé ou entièrement remboursé. Cette action d’annulation supprimera également le prêt du portail utilisateur Affirm du client.

  • 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.
  • If the card is in a captured state, Affirm will auth-expire the card and fully refund the charge.

Mauvaise requête

  • The merchant is not a Platforms vcn merchant.
  • There is no checkout token associated with that checkout_token.
  • Il n’y a pas de carte associée au checkout_token.
  • L'agent actuel n'a pas l'autorisation de mettre à jour la charge (commerçant incorrect).
  • La contestation de la charge est en cours.
  • L'état de la carte n'est pas géré (cela ne devrait jamais se produire, sauf si nous ajoutons un nouvel élément CardState).

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.