Aller au contenu

Vue d'ensemble des flux de paiement

Choisissez comment accepter les paiements par carte avec Cardencer : SDK de paiement, serveur à serveur, capture manuelle, cartes enregistrées ou liens de paiement.

Chaque paiement Cardencer est un objet payment créé avec POST /payments. D'un flux à l'autre, seuls changent l'acteur qui collecte la carte, le moment de la confirmation et le moment de la capture des fonds.

Choisissez une intégration#

Vous souhaitez… Utilisez Les données de carte passent-elles par votre serveur ?
Intégrer un module de paiement à votre site web SDK de paiement (web) Non
Débiter depuis votre backend (cartes enregistrées, VAD/MOTO, votre propre formulaire conforme PCI) Paiements de serveur à serveur Uniquement si vous envoyez des cartes en clair
Envoyer un lien par e-mail, SMS ou messagerie Liens de paiement Non
Vendre sur WooCommerce, PrestaShop, Magento, Shopware ou OpenCart Plugins Non

Flux côté client (recommandé)#

  1. Votre serveur crée le paiement avec votre clé secrète et renvoie son client_secret au navigateur.
  2. Le SDK de paiement collecte la carte dans une iframe hébergée par Cardencer et confirme le paiement.
  3. Si l'émetteur l'exige, le SDK déclenche 3D Secure.
  4. Le client est redirigé vers votre return_url ; votre serveur reçoit un webhook.

Les données de carte passent directement du client à Cardencer, ce qui vous maintient dans le périmètre PCI DSS le plus léger (SAQ A).

Modèles de paiement#

Paiement immédiat (capture automatique)#

Autorisez et capturez en une seule étape. C'est le bon choix pour la plupart des parcours de paiement. Statut final : succeeded. Consultez Paiement immédiat.

json
{ "amount": 4900, "currency": "EUR", "capture_method": "automatic" }

Capture manuelle#

Autorisez maintenant, capturez plus tard, par exemple à l'expédition. Le paiement reste en requires_capture jusqu'à ce que vous appeliez POST /payments/{payment_id}/capture. Consultez Capture manuelle.

json
{ "amount": 4900, "currency": "EUR", "capture_method": "manual" }

Création, mise à jour et confirmation dissociées#

Lorsque le panier évolue pendant le parcours, créez le paiement tôt, mettez-le à jour à mesure que le client modifie sa commande, puis confirmez-le à la fin :

Étape Endpoint
Création POST /payments
Mise à jour du montant, du client ou des adresses POST /payments/{payment_id}
Confirmation POST /payments/{payment_id}/confirm (le SDK s'en charge pour vous)
Capture, si manuelle POST /payments/{payment_id}/capture

3D Secure#

L'authentification forte du client (SCA) s'applique à la plupart des paiements par carte dans l'UE. Cardencer déclenche automatiquement 3DS2 lorsque l'émetteur l'exige ; définissez "authentication_type": "three_ds" pour la demander systématiquement. Le statut passe de requires_customer_action à succeeded. Consultez 3D Secure / SCA.

Cartes enregistrées et paiements récurrents#

Transmettez un customer_id et setup_future_usage pour enregistrer la carte lors du premier paiement, puis débitez-la ultérieurement avec le payment_method_id renvoyé. Consultez Cartes enregistrées et paiements récurrents.

Statuts#

Les statuts finaux ne nécessitent aucune action supplémentaire : succeeded, failed, cancelled et partially_captured. Tous les autres indiquent un paiement en cours. Confirmez toujours le statut final depuis votre serveur, via un webhook ou GET /payments/{payment_id}, avant de traiter une commande.

Méthode de capture Effet
automatic Par défaut. Autorisation et capture simultanées.
manual Autorisation immédiate, capture unique ultérieure (totale ou partielle).
manual_multiple Autorisation immédiate, plusieurs captures possibles dans la limite du montant autorisé.

Consultez la référence de l'API Payments pour le détail de chaque champ.