Passer au contenu principal
Une commande (facture) contient les produits, le client et le prix. Le client paie sur la page hébergée checkout_url, où il choisit l’un des moyens de paiement acceptés par votre boutique. Les commandes créées via l’API suivent les mêmes règles que votre vitrine : les prix proviennent de votre catalogue, le stock est réservé, les coupons et les règles produit s’appliquent, et les contrôles antifraude sont exécutés.

Créer une commande

Réponse (201)
Redirigez le client vers checkout_url. Les commandes impayées expirent au bout de 3 heures.

Produits physiques

Pour les produits à expédier, ajoutez l’adresse. Obtenez d’abord les options avec POST /shipping/quote, ou omettez shipping_rate_id pour utiliser le tarif le moins cher.
Les frais de livraison sont ajoutés à total_cents et indiqués dans shipping_cents. Sans adresse, le client la saisit sur la page de paiement avant de payer. Après le paiement, expédiez la commande avec POST /orders/{invoiceId}/shipments.

Statuts de commande

Écoutez le webhook order.completed plutôt que d’interroger l’API en boucle. Consultez Webhooks.

Après la création de la commande

Utilisez l’identifiant de votre propre commande comme Idempotency-Key pour les appels de création, de finalisation et de remboursement. Ainsi, les nouvelles tentatives ne créent jamais de seconde commande ni de second remboursement.