Créer un panier - Maketou API

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.

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
`webhookUrl`	`string`	Non	URL notifiée lorsque le paiement aboutit ou échoue. Voir Webhooks de panier
`meta`	`object`	Non	Métadonnées personnalisées
`customerPrice`	`number`	Non	Montant à payer défini à la volée pour un produit en prix libre. Il doit être supérieur ou égal au prix minimum du produit

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`	Payload invalide ou `customerPrice` inférieur au minimum — Codes : `VALIDATION_ERROR`, `CUSTOMER_PRICE_BELOW_MINIMUM`

Tester l’endpoint

Ouvrez Créer un panier dans l’API Reference, ajoutez votre clé API, puis envoyez une requête depuis le playground.