Paiements de serveur à serveur
Créez, confirmez et suivez des paiements par carte entièrement depuis votre backend avec l'API REST Cardencer.
Dans une intégration de serveur à serveur (S2S), votre backend pilote l'intégralité du paiement : il crée le paiement, le confirme avec un moyen de paiement et traite le résultat. Utilisez-la pour :
- débiter une carte enregistrée en l'absence du client,
- les commandes par courrier ou par téléphone saisies par vos équipes (VAD/MOTO),
- votre propre formulaire de carte, si votre organisation est conforme PCI DSS pour le traitement des données de carte.
Envoyer des numéros de carte en clair (payment_method_data.card) depuis votre serveur place vos systèmes dans le périmètre PCI DSS complet (SAQ D). Si vous n'êtes pas certifié, collectez les cartes avec le SDK de paiement et réservez le S2S aux débits sur cartes enregistrées.
Prérequis#
- Une clé secrète (
snd_…en sandbox), disponible dans API keys sur le dashboard. - Un
customer_idsi vous souhaitez enregistrer des cartes ou lister les paiements d'un client.
1. Créez ou réutilisez un client#
curl https://sandbox.cardencer.com/customers \
-H "api-key: $CARDENCER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"customer_id": "cus_58211",
"name": "Léa Martin",
"email": "lea@example.com"
}'Si le client existe déjà, réutilisez son customer_id.
2. Créez le paiement#
Vous pouvez créer et confirmer en un seul appel ("confirm": true) ou en deux. Deux appels sont utiles lorsque le montant peut encore changer : créez le paiement tôt, mettez-le à jour avec POST /payments/{payment_id}, puis confirmez-le.
curl https://sandbox.cardencer.com/payments \
-H "api-key: $CARDENCER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount": 6540,
"currency": "EUR",
"confirm": false,
"capture_method": "automatic",
"customer_id": "cus_58211",
"description": "Order 58213"
}'const api = (path, body) =>
fetch(`https://sandbox.cardencer.com${path}`, {
method: "POST",
headers: { "api-key": process.env.CARDENCER_API_KEY, "Content-Type": "application/json" },
body: JSON.stringify(body),
}).then((r) => r.json());
const payment = await api("/payments", {
amount: 6540,
currency: "EUR",
confirm: false,
capture_method: "automatic",
customer_id: "cus_58211",
description: "Order 58213",
});def api(path, body):
return requests.post(
f"https://sandbox.cardencer.com{path}",
headers={"api-key": os.environ["CARDENCER_API_KEY"]},
json=body,
).json()
payment = api("/payments", {
"amount": 6540,
"currency": "EUR",
"confirm": False,
"capture_method": "automatic",
"customer_id": "cus_58211",
"description": "Order 58213",
})Conservez le payment_id renvoyé.
3. Confirmez le paiement#
Avec les données de carte (marchands conformes PCI DSS uniquement) :
curl https://sandbox.cardencer.com/payments/pay_mbabizu24mvu3mela5njyhpit4/confirm \
-H "api-key: $CARDENCER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"payment_method": "card",
"payment_method_type": "credit",
"return_url": "https://example.com/checkout/complete",
"payment_method_data": {
"card": {
"card_number": "4242424242424242",
"card_exp_month": "12",
"card_exp_year": "2030",
"card_holder_name": "Léa Martin",
"card_cvc": "123"
}
},
"browser_info": {
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_0) AppleWebKit/605.1.15",
"accept_header": "text/html,application/xhtml+xml",
"language": "fr-FR",
"color_depth": 24,
"screen_height": 900,
"screen_width": 1440,
"time_zone": -60,
"java_enabled": false,
"java_script_enabled": true,
"ip_address": "203.0.113.10"
}
}'Envoyez les browser_info collectées dans le navigateur du client : les émetteurs s'en servent pour l'analyse de risque 3D Secure, et des données complètes réduisent le nombre d'authentifications demandées.
Avec une carte enregistrée (client absent) :
curl https://sandbox.cardencer.com/payments \
-H "api-key: $CARDENCER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount": 1990,
"currency": "EUR",
"confirm": true,
"customer_id": "cus_58211",
"off_session": true,
"recurring_details": { "type": "payment_method_id", "data": "pm_lmTnIO5EdCiiOrRqT2RF" }
}'Consultez Cartes enregistrées et paiements récurrents pour savoir comment obtenir le payment_method_id.
4. Traitez le résultat#
| Statut | Que faire |
|---|---|
succeeded |
Traitez la commande. |
requires_capture |
Autorisé ; capturez le moment venu. |
requires_customer_action |
Redirigez le client vers next_action.redirect_to_url pour finaliser 3D Secure. |
processing |
Attendez le webhook ou récupérez le paiement plus tard. |
failed |
Affichez error_message et demandez une autre carte. |
Idempotence et nouvelles tentatives#
Les erreurs réseau arrivent. Avant de relancer la création d'un paiement, listez ou récupérez les paiements pour vérifier si la première tentative a abouti, ou transmettez votre propre payment_id unique : une tentative en double sera alors rejetée avec HE_01 au lieu d'être débitée deux fois :
{ "payment_id": "order_58213_attempt_1", "amount": 6540, "currency": "EUR" }Conservez votre clé secrète sur votre backend et journalisez le payment_id de chaque commande.