Contrat API — redirection checkout boutique

POST /api/store/checkout

Cette route valide un plan et retourne l’URL du Hub de paiement officiel. Elle ne crée aucune transaction et ne délivre aucune licence.

Requête

{
  "product_id": "uuid-du-plan",
  "payment_method": "fedapay",
  "coupon_code": "OPTIONNEL",
  "referral_code": "OPTIONNEL"
}

product_id et payment_method sont requis. Un code de réduction invalide renvoie une erreur 404.

Réponse 200

{
  "checkout_url": "https://live.mikhmoai.com/api/v1/payments/hub?productCode=...&planCode=...",
  "final_price": 17400
}

Le client redirige l’acheteur vers checkout_url. Le Hub crée ensuite une transaction PENDING, démarre le prestataire de paiement et attend son webhook authentifié. Seule cette confirmation peut entraîner la délivrance d’une licence.

Garanties et limites

• Une redirection n’est pas une confirmation de paiement.
• Une licence n’est jamais activée par cette route.
• Une offre inactive ou hors catalogue ne peut pas être achetée via le Hub.

Déviation historique

Avant le 29 août 2026, la route inscrivait à tort une transaction SUCCESS avant toute confirmation du prestataire. Ce comportement est supprimé : le Hub officiel est l’unique parcours de paiement.