Affirm.js Quick Guide

Commencez avec Affirm.js (AFJS), la bibliothèque JavaScript côté navigateur d'Affirm. Découvrez comment inclure, initialiser et configurer Affirm.js pour permettre des expériences de caisse fluides. Comprend la configuration, l'utilisation de la clé API et les fonctions de rappel pour l'intégration.

Aperçu

Affirm.js is Affirm’s browser-side JavaScript library that enables seamless integration of Affirm’s payment solutions into your website. This guide provides a complete reference to all available objects and methods, helping you implement Affirm’s checkout, promotional messaging, and transaction workflows efficiently.

En incluant et en initialisant Affirm.js, vous pouvez configurer votre intégration en utilisant votre clé API publique et les paramètres d'environnement. La bibliothèque offre des fonctions pour gérer le passage à la caisse, les interactions avec les utilisateurs et personnaliser l'expérience de paiement. Suivez les instructions de configuration pour commencer et garantir une intégration fluide.

Step 1: Including and Initializing 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>

The Affirm object is your entry point into the rest of the Affirm.js SDK. To create an instance of Affirm, you must pass your public API key and the environment you’re pointing to. Your Affirm public API key is required when calling this function because it identifies your website to Affirm.

Arguments de méthode

AttributTypeDétails
public_api_key
required
stringVotre clé API publique.
script
required
stringSandbox: https://cdn1-sandbox.affirm.com/js/v2/affirm.js
Production: https://cdn1.affirm.com/js/v2/affirm.js

Configuration alternative

If you’re planning to run the Affirm script in other parts of your application, instead of in the global page template, ensure that you set window._affirm_config to the configuration object:

const _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",
	};

window._affirm_config = _affirm_config;

Step 2: Ready

Un rappel peut être transmis à affirm.ui.ready() qui est appelé une fois le chargement de affirm.js terminé.

affirm.ui.ready(function() {  
  console.log('Affirm JS ready!');  
});

Pages recommandées