Vue d'ensemble du SDK de paiement
Intégrez le module de paiement Cardencer à votre site web : cartes, Apple Pay et Google Pay dans un formulaire de paiement unique, sécurisé et personnalisable.
Le SDK de paiement Cardencer affiche un formulaire de paiement dans une iframe hébergée par Cardencer, directement sur votre page. Les données de carte passent du navigateur du client à Cardencer sans jamais transiter par vos serveurs : votre périmètre PCI DSS reste au niveau SAQ A.
Le formulaire de paiement :
- accepte Visa et Mastercard, ainsi qu'Apple Pay et Google Pay lorsque l'appareil les prend en charge,
- déclenche automatiquement les authentifications 3D Secure,
- affiche les cartes enregistrées aux clients fidèles,
- s'adapte à la langue du client et peut reprendre votre identité visuelle.
Vue d'ensemble de l'intégration#
| Étape | Où | Ce qui se passe |
|---|---|---|
| 1 | Votre serveur | POST /payments avec votre clé secrète. Renvoyez le client_secret au navigateur. |
| 2 | Navigateur | Chargez HyperLoader.js depuis sdk.cardencer.com et initialisez-le avec votre clé publiable et votre ID de profil. |
| 3 | Navigateur | Créez le payment element avec le client_secret et montez-le. |
| 4 | Navigateur | À la validation, appelez confirmPayment(). Le SDK gère 3D Secure et redirige vers votre return_url. |
| 5 | Votre serveur | Vérifiez le statut final avec un webhook ou GET /payments/{payment_id}. |
Configurez votre serveur#
Votre serveur crée le paiement et transmet le client_secret au navigateur. N'envoyez jamais votre clé secrète au navigateur.
import express from "express";
const CARDENCER_API = "https://sandbox.cardencer.com"; // https://api.cardencer.com en production
const app = express();
app.use(express.json());
app.post("/create-payment", async (req, res) => {
const order = await loadOrder(req.body.orderId); // calculez le montant sur votre serveur
const response = await fetch(`${CARDENCER_API}/payments`, {
method: "POST",
headers: { "api-key": process.env.CARDENCER_API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
amount: order.amount,
currency: "EUR",
capture_method: "automatic",
customer_id: order.customerId,
description: `Order ${order.id}`,
return_url: "https://example.com/checkout/complete",
}),
});
const payment = await response.json();
if (payment.error) return res.status(400).json({ error: payment.error.message });
res.json({ clientSecret: payment.client_secret });
});
app.listen(4242);import os, requests
from flask import Flask, jsonify, request
CARDENCER_API = "https://sandbox.cardencer.com" # https://api.cardencer.com en production
app = Flask(__name__)
@app.post("/create-payment")
def create_payment():
order = load_order(request.json["orderId"]) # calculez le montant sur votre serveur
payment = requests.post(
f"{CARDENCER_API}/payments",
headers={"api-key": os.environ["CARDENCER_API_KEY"]},
json={
"amount": order.amount,
"currency": "EUR",
"capture_method": "automatic",
"customer_id": order.customer_id,
"description": f"Order {order.id}",
"return_url": "https://example.com/checkout/complete",
},
).json()
if "error" in payment:
return jsonify(error=payment["error"]["message"]), 400
return jsonify(clientSecret=payment["client_secret"])Si le panier change après la création du paiement, mettez celui-ci à jour avec POST /payments/{payment_id} au lieu d'en créer un nouveau.
Chargez le SDK#
Chargez toujours le loader depuis Cardencer ; ne l'intégrez pas à votre bundle et ne l'hébergez pas vous-même :
<script src="https://sdk.cardencer.com/web/0.131.0/v1/HyperLoader.js"></script>Initialisez-le avec la clé publiable et l'ID de profil disponibles dans API keys sur le dashboard. En sandbox, faites pointer customBackendUrl vers l'API sandbox ; en production, vous pouvez l'omettre.
const hyper = window.Hyper(
{ publishableKey: "pk_snd_REPLACE_WITH_YOUR_KEY", profileId: "pro_REPLACE_WITH_YOUR_PROFILE_ID" },
{ customBackendUrl: "https://sandbox.cardencer.com" },
);Pour Apple Pay, le loader doit s'exécuter dans la fenêtre principale de votre page de paiement. Si vous affichez le formulaire de paiement dans votre propre iframe, chargez également HyperLoader.js dans la fenêtre principale.
Choisissez votre intégration#
- React : composants et hooks React.
- HTML/JS : HTML et JavaScript natifs, compatibles avec tout framework.
- Personnalisation : dispositions, thèmes, wallets et polices.
- Codes d'erreur : ce que renvoient le SDK et l'API en cas d'échec.
Accélérez le chargement#
Chargez le SDK le plus tôt possible, idéalement sur la page qui précède le paiement (par exemple le panier). Le loader met ses ressources en cache : le formulaire de paiement s'affiche presque instantanément lorsque le client arrive au paiement.