Aller au contenu

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 pointer customBackendUrl vers https://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 :

bash
# .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_ID

3. Webhooks#

  • Votre endpoint de production est enregistré pour le mode production (consultez Webhooks) et servi en HTTPS.
  • Vous vérifiez X-Webhook-Signature-512 avec 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 amount et currency correspondent à 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 429 et 5xx avec 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, processing et é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.