Paiements
Transmettre le suivi d’une commande
POST/v1/payment-intents/{id}/order-updatespayments:write
Prototype fermé dans le déploiement public. La boutique ne doit pas transmettre le détail du panier. Requires payments:write and a stable Idempotency-Key. The payment must be SUCCEEDED on Alma and have its original sealed order context. Exactly one status or shipment is accepted; values come from the merchant. The queue retains local ordering per payment, retries transient delivery up to eight times, then exposes BLOCKED. These non-financial POSTs may be delivered more than once after a lost response; remote exactly-once ordering is not promised. HTTP 202 acknowledges durable local storage, not Alma acceptance. Already collected orders remain serviceable after connection revocation. Personal content is never returned; sent tracking data is erased locally. Space deletion discards any remaining non-financial delivery and its personal context.
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_…).
Idempotency-Keystringobligatoire
Paramètres
iddans le cheminobligatoire
Corps
statusstring, 1 à 100- Merchant order status. Mutually exclusive with shipment.
is_shippedbooleanshipmentobject- Actual merchant tracking information. Mutually exclusive with status and is_shipped.
Réponses
- 202Demande enregistrée
- 400Requête invalide
- 401Clé absente ou invalide
- 403Autorisation ou espace refusé
- 404Ressource introuvable
- 409Conflit avec une demande existante
- 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.