Aller au contenu

Introduction

Le fonctionnement de Cardencer : une API pour les paiements par carte, un SDK de paiement qui tient les données de carte à l'écart de vos serveurs, et des webhooks signés.

Cardencer permet aux entreprises immatriculées dans l'UE d'accepter Visa, Mastercard, Apple Pay et Google Pay avec une seule intégration. Cardencer exploite la passerelle et configure l'acquéreur pour votre compte : vous n'intégrez que Cardencer.

Ce que vous pouvez créer#

  • Paiement en ligne : intégrez le SDK de paiement à votre site web. Les données de carte passent directement du navigateur du client à Cardencer.
  • Paiements côté serveur : créez et confirmez des paiements depuis votre backend avec l'API REST, par exemple pour débiter une carte enregistrée.
  • Paiements sans code : envoyez un lien de paiement par e-mail ou par messagerie.
  • Plugins e-commerce : installez le plugin WooCommerce, PrestaShop, Magento, Shopware ou OpenCart, collez vos clés et commencez à vendre.

Déroulement d'un paiement#

  1. Votre serveur crée un paiement avec POST /payments et votre clé secrète. Cardencer renvoie un payment_id et un client_secret.
  2. Votre frontend charge le SDK de paiement avec votre clé publiable et le client_secret. Le client saisit sa carte.
  3. Le SDK confirme le paiement. Si l'émetteur exige 3D Secure, le SDK affiche l'authentification.
  4. Cardencer envoie un webhook à votre serveur et le client revient sur votre return_url.
  5. Votre serveur vérifie le statut final avec GET /payments/{payment_id} ou via le webhook, puis traite la commande.

Clés#

Vous utilisez trois valeurs issues du dashboard (page API keys) :

Valeur Exemple Où elle se trouve
Clé API secrète snd_… / prd_… Uniquement sur votre serveur. Envoyée dans l'en-tête api-key.
Clé publiable pk_snd_… / pk_prd_… Votre site ou votre application. Initialise le SDK.
ID de profil pro_… Votre site ou votre application. Identifie votre profil d'entreprise ; ce n'est pas un identifiant d'authentification.

Consultez Authentification pour plus de détails.

Montants et devises#

Les montants sont des entiers exprimés dans la plus petite unité de la devise : 4900 avec "currency": "EUR" correspond à 49,00 EUR. Les devises utilisent les codes ISO 4217.

Statuts de paiement#

Statut Signification
requires_payment_method Créé, en attente des données de carte.
requires_confirmation Données de carte associées, en attente de confirmation.
requires_customer_action Le client doit finaliser 3D Secure.
processing L'acquéreur est encore en train de le traiter.
requires_capture Autorisé, en attente de votre capture.
succeeded Fonds capturés.
failed Refusé ou en erreur. Consultez error_code et error_message.
cancelled Annulé avant la capture.

Étape suivante : suivez le démarrage rapide.