Configurez Maketou, créez un parcours de paiement et confirmez le statut avant d’activer une offre SaaS.
Ce guide montre comment utiliser Maketou pour accepter le paiement d’une offre vendue depuis votre SaaS. Vous configurez le produit et l’accès API dans Maketou. Vous reliez ensuite ce produit à votre propre parcours d’achat.
Créez dans Maketou le produit qui représente l’offre vendue par votre SaaS. Vérifiez qu’il est disponible à la vente avant de commencer l’intégration.
Liste des produits dans Maketou
2
Récupérez l'identifiant public du produit
Ouvrez le produit, cliquez sur Partager, puis copiez son productDocumentId. Votre application utilisera cet identifiant pour créer un panier pour cette offre.
Action Partager dans la fiche du produit
Identifiant public du produit
3
Créez une clé API pour votre boutique
Dans votre boutique, ouvrez Autres, puis Clés API. Créez une clé et conservez-la dans le système de secrets de votre application.
Accès aux clés API
Création d'une clé API
Configuration de la clé API
N’exposez jamais votre clé API dans une application web ou mobile. Votre backend doit être le seul à l’utiliser.
Vous devez associer chaque offre SaaS vendue à son productDocumentId Maketou. Lorsqu’un client choisit une offre, votre backend crée le panier correspondant avec l’API Maketou.Lors de cette création, transmettez les informations du client, une URL de retour vers votre application et les données qui permettent de relier le paiement à votre système, par exemple l’utilisateur, le workspace ou l’offre choisie.
L’API supporte actuellement un seul produit par panier. Ce guide concerne les offres SaaS payantes : un produit gratuit ne retourne pas nécessairement d’URL de paiement.
Après la création du panier, Maketou retourne une URL de paiement. Redirigez votre client vers cette URL pour qu’il finalise son paiement sur la page de checkout Maketou.Enregistrez l’identifiant du panier retourné par Maketou dans votre système. Associez-le à l’utilisateur, au workspace ou à l’offre concernée avant de rediriger le client.
Si vous fournissez une redirectURL, Maketou y ajoute automatiquement le cartId du panier. Au retour du client, votre backend doit consulter le statut de ce panier avec l’API Maketou.Ne considérez pas le retour du navigateur comme une confirmation de paiement. Activez l’offre uniquement après avoir vérifié que le statut du panier est completed.
Statut Maketou
Action attendue dans votre SaaS
completed
Activez l’offre ou la fonctionnalité achetée.
waiting_payment
Informez le client que le paiement est en cours de confirmation.
payment_failed
Informez le client que le paiement a échoué et proposez-lui de recommencer.
abandoned
Laissez l’accès inactif et proposez au client de reprendre le paiement.
Vérifiez le statut avant chaque activation et assurez-vous qu’une même confirmation n’accorde pas plusieurs fois le même accès.
