fragments

logo

Alma Fragments

Une bibliothèque TypeScript pour intégrer la solution de paiement Alma sur votre site marchand

Démarrage rapide

1. Ajoutez Fragments à votre page

<script
  type="text/javascript"
  src="https://unpkg.com/@alma/fragments@1.x/dist/alma-fragments.umd.js"
></script>

2. Créez le conteneur

<div id="alma-payment"></div>

Ce conteneur contiendra l’échéancier et le formulaire de paiement Alma. Ajoutez le à l’endroit où vous souhaitez faire apparaître cet élément sur votre page.

Nous vous recommandons d’ajuster sa largeur et sa hauteur en fonction de la disposition des éléments de votre page.

3. Initialisez Fragments sur votre page de paiement

<script>
  ;(function () {
    const fragments = new Alma.Fragments('<YOUR_MERCHANT_ID>', {
      mode: Alma.ApiMode.TEST,
    })
    const paymentData = getPaymentData()

    fragments.createPaymentForm(paymentData).mount('#alma-payment')
  })()
</script>

Vous pouvez retrouver votre identifiant marchand dans votre dashboard.

La fonction getPaymentData doit être implémentée par vos soins et renvoyer un objet conforme aux données attendues par l’API, telles que décrites dans notre référence d’API. Fragments se chargera d’initialiser le paiement via l’API avant d’effectuer le rendu du formulaire.

Pour aller plus loin

Référez-vous à la documentation complète de la lib !

Exemples