API directe en magasin sans webhooks

Aperçu

L'intégration en magasin (Direct API) d'Affirm permet aux commerçants d'offrir des options de paiement flexibles directement dans leur système de point de vente (POS). Cette variante est conçue pour les commerçants qui préfèrent ne pas maintenir un point de terminaison de webhook public ou dont l'infrastructure (par exemple, les pare-feu, les politiques de sécurité) rend la livraison de webhook peu fiable.

Au lieu de s'appuyer sur des rappels de webhook, les commerçants complètent le flux de transactions en utilisant un processus de confirmation manuel associé à des appels d'autorisation d'API à la demande.

How It Works

Diagramme de flux d'intégration

Le flux de travail en magasin sans webhooks suit ces étapes :

1. Sélectionnez Affirm au moment du paiement

Le vendeur sélectionne Affirm comme option de paiement sur le terminal du point de vente.

2. Créer un objet de paiement

Le système de point de vente appelle l'API de magasin d'Affirm (/api/v2/checkout/store) avec les détails de facturation, les totaux des commandes et les métadonnées.

Affirm retourne un checkout_id et envoie au client un lien de caisse par SMS (production) ou par courriel (environnement de test/live fallback).

3. Le client complète la demande

Le client ouvre le lien sur son appareil, examine les conditions et confirme ou refuse la demande de prêt.

4. Le client informe l'associé

Une fois approuvée, le client informe l'associé en magasin qu'il a complété sa demande Affirm.

5. Autorisation manuelle

L'associé finalise la commande en demandant au système de point de vente d'effectuer un appel API d'autorisation en utilisant les informations enregistrées checkout_id.

6. Confirmation de commande

Si l'autorisation réussit, le commerçant enregistre l'identifiant de prêt du client et le PDV affiche un message de succès.

Si l'autorisation échoue, l'associé reçoit un message d'erreur et peut conseiller le client en conséquence.

7. Mise à jour de l'état de la commande

Le TPV met à jour le statut de la commande pour indiquer que la transaction est terminée.