> ## Documentation Index
> Fetch the complete documentation index at: https://docs-api.maketou.com/llms.txt
> Use this file to discover all available pages before exploring further.
> ## Agent Instructions
> Utilisez l'API Maketou v1 décrite par la spécification OpenAPI de ce site.
> Gardez la clé API côté serveur et ne l'exposez jamais dans du code client, des logs ou une réponse destinée au navigateur.
> Ne livrez un produit et n'activez un accès que lorsque le statut du panier est `completed`.
> N'inventez pas d'endpoint, de champ ou de webhook absent de la documentation.
# Accepter des paiements dans votre SaaS
> 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.
```text theme={null}
Offre SaaS → Panier Maketou → Paiement → Confirmation → Accès activé
```
## Préparez votre offre dans Maketou
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.
Ouvrez le produit, cliquez sur **Partager**, puis copiez son `productDocumentId`. Votre application utilisera cet identifiant pour créer un panier pour cette offre.
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.
N'exposez jamais votre clé API dans une application web ou mobile. Votre backend doit être le seul à l'utiliser.
## Reliez votre application à Maketou
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.
## Redirigez le client vers le 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.
## Confirmez le paiement avant d'activer l'offre
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.
## Continuez avec l'API Reference
Consultez les données à transmettre pour créer un panier et initier le paiement.
Consultez le statut d'un panier avant d'activer une offre.