Démarrage rapide
Créez votre premier paiement de test dans la sandbox Cardencer en cinq minutes, avec curl, Node.js ou Python.
Ce guide vous accompagne de la création de votre compte jusqu'à un paiement de test réussi. Il vous faut un terminal et cinq minutes.
1. Créez un compte#
Inscrivez-vous et finalisez l'onboarding. Votre sandbox est disponible dès la création de votre compte ; les clés de production suivent une fois votre entreprise vérifiée.
2. Obtenez une clé sandbox#
- Ouvrez le dashboard et rendez-vous dans API keys.
- Créez une clé de test. Elle commence par
snd_. - Copiez immédiatement la clé complète : Cardencer la stocke sous forme hachée et ne l'affiche qu'une seule fois. Une valeur contenant
********est un identifiant masqué et ne permet pas de s'authentifier.
Exportez-la pour que les exemples ci-dessous fonctionnent tels quels :
export CARDENCER_API_KEY="snd_REPLACE_WITH_YOUR_FULL_KEY"3. Créez un paiement#
Envoyez un paiement à la sandbox avec une carte de test. confirm: true associé à capture_method: "automatic" autorise et capture le paiement en un seul appel.
curl https://sandbox.cardencer.com/payments \
-H "api-key: $CARDENCER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount": 4900,
"currency": "EUR",
"confirm": true,
"capture_method": "automatic",
"description": "Order 58211",
"payment_method": "card",
"payment_method_type": "credit",
"payment_method_data": {
"card": {
"card_number": "4242424242424242",
"card_exp_month": "12",
"card_exp_year": "2030",
"card_holder_name": "Test Customer",
"card_cvc": "123"
}
}
}'const res = 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",
confirm: true,
capture_method: "automatic",
description: "Order 58211",
payment_method: "card",
payment_method_type: "credit",
payment_method_data: {
card: {
card_number: "4242424242424242",
card_exp_month: "12",
card_exp_year: "2030",
card_holder_name: "Test Customer",
card_cvc: "123",
},
},
}),
});
const payment = await res.json();
console.log(payment.payment_id, payment.status);import os, requests
res = requests.post(
"https://sandbox.cardencer.com/payments",
headers={"api-key": os.environ["CARDENCER_API_KEY"]},
json={
"amount": 4900,
"currency": "EUR",
"confirm": True,
"capture_method": "automatic",
"description": "Order 58211",
"payment_method": "card",
"payment_method_type": "credit",
"payment_method_data": {
"card": {
"card_number": "4242424242424242",
"card_exp_month": "12",
"card_exp_year": "2030",
"card_holder_name": "Test Customer",
"card_cvc": "123",
}
},
},
)
payment = res.json()
print(payment["payment_id"], payment["status"])La réponse contient le paiement. Repérez notamment :
{
"payment_id": "pay_mbabizu24mvu3mela5njyhpit4",
"status": "succeeded",
"amount": 4900,
"amount_received": 4900,
"currency": "EUR",
"capture_method": "automatic",
"client_secret": "pay_mbabizu24mvu3mela5njyhpit4_secret_el9ksDkiB8hi6j9N78yo"
}"status": "succeeded" signifie que le paiement est autorisé et capturé. Il apparaît désormais dans Payments sur le dashboard.
Envoyer des numéros de carte en clair depuis votre serveur, comme ci-dessus, ne pose pas de problème en sandbox. En production, collectez les cartes avec le SDK de paiement : les données de carte ne transitent jamais par vos serveurs et votre périmètre PCI DSS reste minimal.
4. Récupérez le paiement#
curl https://sandbox.cardencer.com/payments/pay_mbabizu24mvu3mela5njyhpit4 \
-H "api-key: $CARDENCER_API_KEY"const res = await fetch(`https://sandbox.cardencer.com/payments/${paymentId}`, {
headers: { "api-key": process.env.CARDENCER_API_KEY },
});
console.log((await res.json()).status);res = requests.get(
f"https://sandbox.cardencer.com/payments/{payment_id}",
headers={"api-key": os.environ["CARDENCER_API_KEY"]},
)
print(res.json()["status"])5. Testez un refus#
Relancez la même requête avec 4000000000000002. Le paiement revient avec "status": "failed", ainsi qu'un error_code et un error_message qui en expliquent la raison. Consultez Environnement de test et cartes de test pour tous les scénarios.