API directe en magasin sans webhooks

Aperçu

L'intégration en magasin (API directe) d'Affirm permet aux commerçants d'offrir des options de paiement flexibles directement à partir de leurs systèmes de point de vente (PDV).Cette solution est conçue pour les commerçants qui préfèrent ne pas gérer de point de terminaison webhook public ou dont l'infrastructure (pare-feu, politiques de sécurité, etc.) rend la distribution des webhooks 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

The POS system calls Affirm’s Store API (/api/v2/checkout/store) with billing details, order totals, and metadata.

Affirm returns a checkout_id and sends the customer a checkout link via SMS (production) or email (sandbox/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

The associate finalizes the order by instructing the POS to make an Authorization API call using the saved 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.