DocsTableau de bord

Caisse

Créer une session de caisse

POST/v1/checkout-sessionspayments:write

Autorisation payments:write. Ouvre la caisse d’un paiement : renvoie checkout_url et launch_token, à envoyer dans le corps d’un formulaire POST. Ne débite rien. Avec return_url, l’acheteur revient sur votre boutique.

En-têtes

AuthorizationBearer pos_key_…obligatoire
Clé de serveur, pour tout l’espace. Jamais dans un navigateur.
X-Merchant-IDstringobligatoire
L’espace marchand concerné (mrc_…).

Corps

payment_idstringobligatoire
return_urlstring, 0 à 2048
La page de votre boutique où revient l’acheteur. Même origine qu’une de vos adresses de notification, en https.

Réponses

201Créé
400Requête invalide
401Clé absente ou invalide
403Autorisation ou espace refusé
404Ressource introuvable
409Conflit avec une demande existante
410N’existe plus
429Trop de demandes, réessayez plus tard
503Service momentanément indisponible

Une erreur ne vaut jamais paiement. Le corps donne code, message, request_id et retry_action ; renvoyez la même Idempotency-Key si retry_action le propose.