Configurer Split Capture
Intégrez facilement la fonction de capture fractionnée d’Affirm pour proposer des options de paiement flexibles, personnaliser l’expérience pour qu’elle corresponde à votre marque et assurer un passage à la caisse fluide et sécurisé pour vos clients.
Conditions préalables
- Configurez votre compte Affirm pour accéder à vos informations d’identification de compte marchand.
Étapes
1. Ajouter Affirm.js
Ajouter le script Affirm.js à votre site. Le script se charge directement depuis le domaine Affirm.
Clés API Sandbox
Utilisez uniquement vos clés API et votre domaine d’environnement de test pendant les essais et le développement. Cela garantit que vous ne modifiez pas accidentellement les transactions en direct.
<script>
var _affirm_config = {
public_api_key: "YOUR_PUBLIC_API_KEY", /* replace with public api key */
script: "https://cdn1-sandbox.affirm.com/js/v2/affirm.js",
locale: "en_US",
country_code: "USA",
};
(function(m,g,n,d,a,e,h,c){var b=m[n]||{},k=document.createElement(e),p=document.getElementsByTagName(e)[0],l=function(a,b,c){return function(){a[b]._.push([c,arguments])}};b[d]=l(b,d,"set");var f=b[d];b[a]={};b[a]._=[];f._=[];b._=[];b[a][h]=l(b,a,h);b[c]=function(){b._.push([h,arguments])};a=0;for(c="set add save post open empty reset on off trigger ready setProduct".split(" ");a<c.length;a++)f[c[a]]=l(b,d,c[a]);a=0;for(c=["get","token","url","items"];a<c.length;a++)f[c[a]]=function(){};k.async=
!0;k.src=g[e];p.parentNode.insertBefore(k,p);delete g[e];f(g);m[n]=b})(window,_affirm_config,"affirm","checkout","ui","script","ready","jsReady");
</script>
L'ajout de Affirm.js
crée une instance d'Affirm sur votre client. Cela vous donne accès aux méthodes suivantes dans l'objet Affirm pour déclencher plusieurs actions:
affirm.checkout({ })
- Stocke l'objet de paiement et est utilisé pour la charge utile de la requête de paiement.affirm.checkout.post()
- Envoie l'objet de paiement via une requêtePOST
.
2. Initier la caisse
Créez un objet de caisse et lancez le processus de caisse avec la fonction Caisse. L’intégration de la caisse Affirm permet à vos clients d’utiliser Affirm pour payer leurs achats sur votre site.
affirm.checkout({
"merchant": {
"user_confirmation_url": "https://merchantsite.com/confirm",
"user_cancel_url": "https://merchantsite.com/cancel",
"user_confirmation_url_action": "POST",
"name": "Your Customer-Facing Merchant Name"
},
"shipping":{
"name":{
"first":"Joe",
"last":"Doe"
},
"address":{
"line1":"633 Folsom St",
"line2":"Floor 7",
"city":"San Francisco",
"state":"CA",
"zipcode":"94107",
"country":"USA"
},
"phone_number": "4153334567",
"email": "[email protected]"
},
"billing":{
"name":{
"first":"Joe",
"last":"Doe"
},
"address":{
"line1":"633 Folsom St",
"line2":"Floor 7",
"city":"San Francisco",
"state":"CA",
"zipcode":"94107",
"country":"USA"
},
"phone_number": "4153334567",
"email": "[email protected]"
},
"items": [{
"display_name": "Awesome Pants",
"sku": "ABC-123",
"unit_price": 1999,
"qty": 3,
"item_image_url": "http://merchantsite.com/images/awesome-pants.jpg",
"item_url": "http://merchantsite.com/products/awesome-pants.html"
"categories": [
["Home", "Bedroom"],
["Home", "Furniture", "Bed"]
],
}],
"shipping_amount": 1000,
"tax_amount": 500,
"total": 5997
});
affirm.checkout.open()
Créer un objet checkout
Vous pouvez trouver plus de renseignements sur la façon de créer un objet de paiement via notre bibliothèque Javascript Affirm.
3. Gérer les rappels
Une fois que vous avez lancé un paiement et que le client a confirmé son prêt Affirm, nous envoyons une demande HTTP avec le checkout_token
à l'URL que vous avez définie dans l'objet checkout (user_confirmation_url
).
Par défaut, nous envoyons cette requête via POST
. Vous pouvez configurer l'objet de paiement pour que nous envoyions cette requête via GET
.
Pour choisir comment nous envoyons le checkout_token
, vous pouvez définir le paramètre user_confirmation_url_action
dans l'objet de paiement à :
POST
pour envoyer lecheckout_token
dans le corps de la requête HTTP (paramètre par défaut).GET
pour envoyer lecheckout_token
dans la chaîne de requête de la demande HTTP.
4. Créer une transaction
Lorsqu'un client réussit à passer à la caisse, il est enregistré comme une nouvelle tentative d'achat. Cela doit être géré côté serveur pour être exécuté par notre API de transaction.
Quelle est la prochaine étape?
Mis à jour 13 days ago