Passer au contenu principal
Ce guide vous accompagne tout au long d’une commande complète avec la Store API PapelShip : créer une commande pour l’un de vos produits, rediriger le client vers la page de paiement hébergée, puis confirmer le paiement avant de vous y fier.

Prérequis

  • Une boutique PapelShip avec au moins un produit
  • Une clé Store API (pk_live_...) disposant de l’autorisation orders:write, et l’identifiant de votre boutique pour l’en-tête x-store-hash
Vous trouverez les deux dans le tableau de bord PapelShip, dans les paramètres API de votre boutique. Consultez Authentification.
1

Créer une commande

Envoyez l’e-mail du client et les produits. Ajoutez un en-tête Idempotency-Key afin que les nouvelles tentatives ne créent jamais de seconde commande.
2

Rediriger le client vers le paiement

La réponse contient la commande avec son checkout_url. Redirigez-y le client pour qu’il paie avec l’un des moyens de paiement acceptés par votre boutique.
Réponse (201)
Enregistrez invoice.id avec votre commande. Les commandes impayées expirent au bout de 3 heures. Pour débiter une carte immédiatement, ou pour afficher le formulaire de carte sur votre propre site, consultez PapelPay.
3

Confirmer le paiement

Ne vous fiez jamais au seul retour du client sur votre site. Écoutez le webhook order.completed, ou lisez la commande depuis votre serveur :
La commande est payée et livrée lorsque status vaut completed.
Conservez votre clé API sur votre serveur. Ne l’incluez jamais dans du code exécuté dans le navigateur, dans des applications mobiles ou dans des clients de bureau.

Étapes suivantes

Commandes

Produits physiques, statuts, annulation et remboursements.

PapelPay

Paiements par carte, abonnements et formulaire de carte sur votre site.