Intégration React
Ajoutez le module de paiement Cardencer à une application React : chargez le SDK depuis sdk.cardencer.com, montez le formulaire dans un composant et confirmez le paiement.
Ce guide construit une page de paiement en React. Il charge le SDK web Cardencer depuis sdk.cardencer.com et l'enveloppe dans un petit composant : rien à installer depuis npm.
Avant de commencer, configurez votre serveur pour que POST /create-payment renvoie un clientSecret.
1. Chargez le SDK#
Créez un utilitaire qui charge le loader Cardencer une seule fois et renvoie l'instance du SDK. Appelez-le au niveau racine de votre application (en dehors des composants) pour que le SDK commence à se charger avant que le client n'arrive au paiement.
const LOADER = "https://sdk.cardencer.com/web/0.131.0/v1/HyperLoader.js";
export function loadCardencer({ publishableKey, profileId, backendUrl }) {
return new Promise((resolve, reject) => {
const init = () => resolve(window.Hyper({ publishableKey, profileId }, backendUrl ? { customBackendUrl: backendUrl } : {}));
if (window.Hyper) return init();
const script = document.createElement("script");
script.src = LOADER;
script.async = true;
script.onload = init;
script.onerror = () => reject(new Error("Le SDK Cardencer n'a pas pu être chargé"));
document.head.appendChild(script);
});
}
export const cardencerPromise = loadCardencer({
publishableKey: "pk_snd_REPLACE_WITH_YOUR_KEY",
profileId: "pro_REPLACE_WITH_YOUR_PROFILE_ID",
backendUrl: "https://sandbox.cardencer.com", // à omettre en production
});Pour Apple Pay, le loader doit s'exécuter dans la fenêtre principale. Ne le chargez pas uniquement dans une iframe.
2. Montez le formulaire de paiement#
Créez le paiement dès le chargement de la page de paiement, puis montez le formulaire sécurisé dans un conteneur référencé par un ref.
import { useEffect, useRef, useState } from "react";
import { cardencerPromise } from "./cardencer";
export default function Checkout() {
const container = useRef(null);
const [sdk, setSdk] = useState(null);
const [widgets, setWidgets] = useState(null);
const [message, setMessage] = useState(null);
const [isLoading, setIsLoading] = useState(false);
useEffect(() => {
let cancelled = false;
(async () => {
const [cardencer, res] = await Promise.all([
cardencerPromise,
fetch("/create-payment", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ orderId: "58211" }),
}),
]);
const { clientSecret } = await res.json();
if (cancelled) return;
const elements = cardencer.widgets({ clientSecret, appearance: { theme: "default" } });
elements
.create("payment", { layout: "tabs", wallets: { walletReturnUrl: "https://example.com/checkout/complete" } })
.mount(container.current);
setSdk(cardencer);
setWidgets(elements);
})();
return () => { cancelled = true; };
}, []);
const handleSubmit = async (event) => {
event.preventDefault();
if (!sdk || !widgets) return;
setIsLoading(true);
setMessage(null);
const { error, status } = await sdk.confirmPayment({
widgets,
confirmParams: { return_url: "https://example.com/checkout/complete" },
redirect: "if_required",
});
if (error) setMessage(error.message ?? "Votre paiement n'a pas pu aboutir. Veuillez réessayer.");
else if (status === "succeeded" || status === "processing") window.location.assign("/checkout/complete");
setIsLoading(false);
};
return (
<form onSubmit={handleSubmit}>
<div ref={container} />
<button disabled={isLoading || !widgets}>{isLoading ? "Traitement…" : "Payer"}</button>
{message && <p role="alert">{message}</p>}
</form>
);
}Si la carte nécessite 3D Secure, le SDK affiche l'authentification et, selon la banque, redirige vers votre return_url. Les refus et les erreurs de validation reviennent dans error.
3. Affichez le résultat sur la page de retour#
Le SDK ajoute payment_intent_client_secret à votre return_url. Lisez-le pour afficher le résultat :
import { useEffect, useState } from "react";
import { cardencerPromise } from "./cardencer";
export default function Complete() {
const [status, setStatus] = useState(null);
useEffect(() => {
const clientSecret = new URLSearchParams(window.location.search).get("payment_intent_client_secret");
if (!clientSecret) return;
cardencerPromise
.then((cardencer) => cardencer.retrievePaymentIntent(clientSecret))
.then(({ paymentIntent }) => setStatus(paymentIntent.status));
}, []);
if (status === "succeeded") return <p>Paiement réussi. Merci !</p>;
if (status === "processing") return <p>Votre paiement est en cours de traitement.</p>;
if (status) return <p>Votre paiement n'a pas abouti. Essayez une autre carte.</p>;
return null;
}N'expédiez pas une commande sur la base du statut affiché dans le navigateur. Attendez le webhook payment_succeeded ou récupérez le paiement depuis votre serveur.
Événements du formulaire#
Le formulaire de paiement émet des événements que vous pouvez écouter après l'avoir monté :
const paymentElement = elements.create("payment", options);
paymentElement.on("ready", () => setReady(true));
paymentElement.on("change", (event) => setComplete(event.complete));
paymentElement.mount(container.current);L'événement change ressemble à { elementType: "payment", complete: false, empty: false, value: { type: "card" } }.
Testez#
Utilisez 4242 4242 4242 4242 et 4000 0038 0000 0446 (3D Secure). Voir Environnement de test et cartes de test.
Suite : personnalisez le formulaire.