Paiement immédiat (capture automatique)
Autorisez et capturez un paiement par carte en une seule étape : le modèle de paiement ponctuel le plus simple et le plus courant.
Un paiement immédiat débite la carte dès que le client confirme. L'autorisation et la capture ont lieu simultanément, sans autre appel de votre backend. C'est le bon modèle pour la plupart des parcours de paiement.
Fonctionnement#
- Votre backend appelle
POST /paymentsavec"capture_method": "automatic". - Cardencer renvoie le paiement avec un
client_secret. - Votre frontend transmet le
client_secretau SDK de paiement, qui affiche le formulaire de paiement. - Le client saisit sa carte et clique sur payer ; le SDK confirme le paiement.
- Cardencer obtient l'autorisation et la capture auprès de l'acquéreur, puis renvoie
succeeded.
1. Créez le paiement sur votre serveur#
curl https://sandbox.cardencer.com/payments \
-H "api-key: $CARDENCER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount": 4900,
"currency": "EUR",
"capture_method": "automatic",
"customer_id": "cus_58211",
"description": "Order 58211",
"return_url": "https://example.com/checkout/complete"
}'import express from "express";
const app = express();
app.use(express.json());
app.post("/create-payment", async (req, res) => {
const response = await fetch("https://sandbox.cardencer.com/payments", {
method: "POST",
headers: { "api-key": process.env.CARDENCER_API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
amount: 4900,
currency: "EUR",
capture_method: "automatic",
description: "Order 58211",
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
app = Flask(__name__)
@app.post("/create-payment")
def create_payment():
payment = requests.post(
"https://sandbox.cardencer.com/payments",
headers={"api-key": os.environ["CARDENCER_API_KEY"]},
json={
"amount": 4900,
"currency": "EUR",
"capture_method": "automatic",
"description": "Order 58211",
"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"])Le paiement démarre au statut requires_payment_method. Calculez le montant sur votre serveur ; ne vous fiez jamais à un montant envoyé par le navigateur.
2. Collectez la carte et confirmez#
Affichez le module de paiement avec le client_secret et votre clé publiable. Suivez React ou HTML/JS pour le code frontend complet ; l'essentiel tient en quelques lignes :
const hyper = window.Hyper(
{ publishableKey: "pk_snd_REPLACE_WITH_YOUR_KEY", profileId: "pro_REPLACE_WITH_YOUR_PROFILE_ID" },
{ customBackendUrl: "https://sandbox.cardencer.com" },
);
const widgets = hyper.widgets({ clientSecret });
widgets.create("payment").mount("#payment-element");
const { error } = await hyper.confirmPayment({
confirmParams: { return_url: "https://example.com/checkout/complete" },
redirect: "if_required",
});3. Vérifiez le résultat sur votre serveur#
Lorsque le client revient, ou lorsque votre webhook reçoit payment_succeeded, récupérez le paiement et ne traitez la commande que si status vaut succeeded et que le montant correspond.
curl https://sandbox.cardencer.com/payments/pay_mbabizu24mvu3mela5njyhpit4 \
-H "api-key: $CARDENCER_API_KEY"Alternative 100 % serveur#
Si vous collectez vous-même les cartes dans le cadre de PCI DSS, créez et confirmez le paiement en un seul appel en ajoutant "confirm": true et payment_method_data, comme dans le démarrage rapide. Consultez Paiements de serveur à serveur.