Guide d'intégration en magasin

Disponibilité des pays

Liste des pays ⬇️

USA

Canada

UK

Aperçu

L'intégration en magasin d'Affirm permet aux commerçants d'offrir Affirm comme option de paiement dans leurs systèmes de point de vente (PDV). Ce guide vous explique le processus d'intégration d'Affirm, depuis l'initialisation des paiements en magasin jusqu'à la confirmation et la gestion des transactions.

Lorsqu'un client choisit Affirm lors du passage à la caisse, un lien de paiement lui est envoyé par courriel ou par texto, ce qui lui permet de finaliser son achat sur son propre appareil. Une fois approuvé, Affirm notifie votre système, permettant une autorisation et une confirmation de commande sans heurts.

En intégrant la solution en magasin d'Affirm, les commerçants peuvent offrir à leurs clients des options de paiement flexibles tout en assurant une expérience de transaction fluide au point de vente.

How It Works

Ce diagramme démontre la manière dont vos clients, votre système de vente, votre serveur (par ex., OMS) et Affirm interagissent :

1. Paiement en magasin

Les associés des ventes sélectionneront Affirm comme option de paiement dans votre système de point de vente. Cette action déclenchera une demande à Affirm d'envoyer directement un lien de paiement (par courriel/texte) aux clients.

POST /api/v2/checkout/store HTTP/1.1
Host: sandbox.affirm.com
Content-Type: application/json

{
      "merchant": {
        "public_api_key":               "PUBLIC_API_KEY",
        "user_cancel_url":				"https://www.google.com",
        "user_confirmation_url":        "https://www.affirm.com",
        "user_confirmation_url_action": "POST",
       "name":                         "In-store Affirm demo"
      },
      "billing":{
        "name":{
          "full":                        "John Doe"
        },
        "address":{
          "line1":                       "325 Pacific Ave",
          "city":                        "San Francisco",
          "state":                       "CA",
          "zipcode":                     "94112",
          "country":                     "USA"
        },
        "phone_number":                  "4155552222",
        "email":                         "[email protected]"
      },
  "metadata": {
    "entity_name": "Vignan 1234",
    "store_location": "Denver"
  },
      "order_id":                        "00de5cee-7226-4aec-b729-a571f773a58c",
      "total":                           5000         
  }

🚧

Réception de l’URL de paiement

L'API Store n'enverra des SMS que dans l'environnement Affirm Live. Pendant les tests de l'environnement Sandbox, veuillez vous fier aux messages électroniques pour recevoir l'URL de paiement, afin de finaliser votre achat Affirm.

2. Événement de confirmation du webhook

Lorsqu'un utilisateur reçoit et confirme son prêt, le serveur d'Affirm sera informé de cet événement. Un checkout_id sera renvoyé sur votre serveur à l'URL du webhook que vous avez fourni

3. Créer une commande

Sur confirmation, le serveur d'Affirm POST renverra à votre serveur un événement de paiement contenant le checkout_id. Ce checkout_id aussi appelé transaction_id doit être autorisé de manière sécurisée avant d'enregistrer la commande ou de mettre à jour le statut de la commande sur le terminal du magasin.

4. Confirmation en magasin

Après une autorisation réussie via Affirm, le terminal en magasin doit pouvoir recevoir la confirmation de commande et refléter le statut payé en temps quasi réel.

5. Gérer la commande

Vous pouvez lancer différentes actions de transaction en fonction de vos processus internes.