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é)#
- Votre serveur crée le paiement avec votre clé secrète et renvoie son
client_secretau navigateur. - Le SDK de paiement collecte la carte dans une iframe hébergée par Cardencer et confirme le paiement.
- Si l'émetteur l'exige, le SDK déclenche 3D Secure.
- 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.
{ "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.
{ "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.