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_idstringobligatoirereturn_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.