Aller au contenu

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#

  1. Votre backend appelle POST /payments avec "capture_method": "automatic".
  2. Cardencer renvoie le paiement avec un client_secret.
  3. Votre frontend transmet le client_secret au SDK de paiement, qui affiche le formulaire de paiement.
  4. Le client saisit sa carte et clique sur payer ; le SDK confirme le paiement.
  5. 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"
  }'

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 :

js
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.