Créer un panier

Cet endpoint crée un panier et initie le processus de paiement. La réponse fournit une redirectUrl. Redirigez votre client vers cette URL pour qu’il procède au paiement.

Cet endpoint est soumis aux limites de fréquence. Si vous dépassez une limite, l’API retourne le code HTTP 429 et le header Retry-After.

Endpoint

POST https://api.maketou.net/api/v1/stores/cart/checkout

Body

Paramètre	Type	Requis	Description
`productDocumentId`	`string`	Oui	Identifiant public du produit
`email`	`string`	Oui	Adresse email du client
`firstName`	`string`	Oui	Prénom du client
`lastName`	`string`	Oui	Nom du client
`phone`	`string`	Non	Numéro de téléphone du client
`redirectURL`	`string`	Non	URL de retour après paiement
`meta`	`object`	Non	Métadonnées personnalisées
`customerPrice`	`number`	Non	Prix choisi par le client pour un produit en prix libre

Exemple de payload

{
  "productDocumentId": "550e8400-e29b-41d4-a716-446655440000",
  "email": "client@example.com",
  "firstName": "Jean",
  "lastName": "Dupont",
  "phone": "+33612345678",
  "redirectURL": "https://monsite.com/confirmation",
  "meta": {
    "userId": "12345",
    "source": "website"
  }
}

Réponse

{
  "cart": {
    "id": "fd2d91d7-20d2-4b86-b067-d474fb0d1e60",
    "createdAt": "2025-11-28T14:27:00.805Z",
    "updatedAt": "2025-11-28T14:27:00.805Z",
    "status": "waiting_payment",
    "customerInfo": {
      "firstName": "John",
      "lastName": "Doe",
      "email": "customer@example.com",
      "phone": "+33612345678",
      "lang": "fr-FR"
    }
  },
  "redirectUrl": "https://checkout.moneroo.io/py_mj2m7m6gfro8"
}

Erreurs

Code HTTP	Description
`400`	Produit invalide ou indisponible — Code : `INVALID_PRODUCT`
`401`	Clé API invalide ou manquante — Code : `INVALID_API_KEY`
`422`	Le format attendu pour la payload n’est pas respecté — Code : `VALIDATION_ERROR`
`429`	Limite de fréquence dépassée — Code : `RATE_LIMITED`. Voir Limites de fréquence

Tester l’endpoint

Ouvrez Créer un panier dans l’API Reference, ajoutez votre clé API, puis envoyez une requête depuis le playground. Consultez les headers X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset dans la réponse pour suivre votre consommation.

Introduction

Guides

Resources

Endpoint

Body

Exemple de payload

Réponse

Erreurs

Tester l’endpoint

​Endpoint

​Body

​Exemple de payload

​Réponse

​Erreurs

​Tester l’endpoint

Endpoint

Body

Exemple de payload

Réponse

Erreurs

Tester l’endpoint