Configurer en magasin
Intégrez Affirm à votre système de point de vente pour proposer des options de paiement flexibles en magasin. Ce guide couvre l'initialisation des caisses, l'envoi de liens de paiement, l'autorisation des transactions et la gestion des commandes pour une expérience client fluide.
Conditions préalables
- Créez un compte dans le Tableau de bord des commerçants Affirm.
- Consultez la référence de l'API Transactions.
Étapes
1. Paiement en magasin
Les associés aux ventes sélectionnent Affirm comme option de paiement dans votre système de point de vente (PDV). Cette action déclenche une demande à Affirm d'envoyer directement un lien de paiement par courriel ou par texto au client.
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 Magasin envoie des SMS uniquement dans l'environnement Affirm Live. Pendant les tests de l’environnement de test, utilisez les 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 est informé de cet événement. Un checkout_id
est renvoyé sur votre serveur à l'URL du webhook que vous fournissez.
3. Créer une commande
Sur confirmation, le serveur d'Affirm renvoie à 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.
Quelle est la prochaine étape?
Mis à jour 12 days ago