Passer en production
Liste de contrôle pour faire passer votre intégration Cardencer de la sandbox aux paiements réels avec les clés prd_.
Parcourez cette liste de contrôle avant d'accepter de vrais paiements. Cardencer configure l'acquéreur pour votre compte : passer en production consiste surtout à vérifier vos clés, vos webhooks et votre gestion des erreurs.
1. Compte#
- Votre onboarding est terminé et votre entreprise est vérifiée. Le dashboard n'affiche les clés de production qu'après validation.
- Le compte bancaire de règlement (IBAN) communiqué lors de l'onboarding est correct.
2. Changez de clés et d'hôtes#
| Sandbox | Production | |
|---|---|---|
| URL de base | https://sandbox.cardencer.com |
https://api.cardencer.com |
| Clé secrète | snd_… |
prd_… |
| Clé publiable | pk_snd_… |
pk_prd_… |
- Créez une clé secrète de production dans API keys et stockez-la dans vos secrets de production, jamais dans le code.
- Sur votre serveur, remplacez l'URL de base de la sandbox par
https://api.cardencer.com. - Initialisez le SDK de paiement avec votre clé
pk_prd_et faites pointercustomBackendUrlvershttps://api.cardencer.com(ou supprimez ce paramètre : la production est la valeur par défaut du SDK). - Votre clé secrète n'est exposée ni sur votre site ni dans votre application mobile.
Séparez la configuration par environnement, par exemple :
# .env.production
CARDENCER_API_BASE=https://api.cardencer.com
CARDENCER_API_KEY=prd_REPLACE_WITH_YOUR_FULL_KEY
CARDENCER_PUBLISHABLE_KEY=pk_prd_REPLACE_WITH_YOUR_KEY
CARDENCER_PROFILE_ID=pro_REPLACE_WITH_YOUR_PROFILE_ID3. Webhooks#
- Votre endpoint de production est enregistré pour le mode production (consultez Webhooks) et servi en HTTPS.
- Vous vérifiez
X-Webhook-Signature-512avec votre clé de signature des webhooks de production. - Le traitement est idempotent sur
event_id.
4. Sécurisez vos paiements#
- Avant de traiter une commande, récupérez le paiement depuis votre serveur (
GET /payments/{payment_id}) ou appuyez-vous sur un webhook vérifié. Ne vous fiez jamais au statut transmis par votre frontend. - Vérifiez que
amountetcurrencycorrespondent à la commande. - Votre page de paiement est servie en HTTPS et charge le SDK depuis
https://sdk.cardencer.com.
5. Gestion des erreurs#
- Votre serveur gère chaque erreur d'API et affiche un message clair au client.
- Votre page de paiement gère les erreurs du SDK et permet au client de réessayer avec une autre carte.
- Vous réessayez les réponses
429et5xxavec un backoff, et vous ne relancez jamais la création d'un paiement sans vérifier si la première tentative a abouti. - Vous avez testé dans la sandbox les refus, 3D Secure, les remboursements et, si vous l'utilisez, la capture manuelle.
6. Expérience de paiement#
- Le bouton de paiement est bien visible.
- Le module de paiement reprend votre identité visuelle (personnalisation).
- Votre page de retour affiche le bon message pour les paiements
succeeded,processinget échoués.
7. Premier paiement réel#
Effectuez un petit paiement réel avec votre propre carte, vérifiez qu'il apparaît dans Payments sur le dashboard, puis remboursez-le.