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#
- Votre serveur crée un paiement avec
POST /paymentset votre clé secrète. Cardencer renvoie unpayment_idet unclient_secret. - Votre frontend charge le SDK de paiement avec votre clé publiable et le
client_secret. Le client saisit sa carte. - Le SDK confirme le paiement. Si l'émetteur exige 3D Secure, le SDK affiche l'authentification.
- Cardencer envoie un webhook à votre serveur et le client revient sur votre
return_url. - 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.