Going live
Checklist to move your Cardencer integration from the sandbox to live payments with prd_ keys.
Work through this checklist before you take real payments. Cardencer configures the acquirer for your account, so going live is mostly about your keys, webhooks and error handling.
1. Account#
- Your onboarding is complete and your business is verified. The dashboard shows live keys only after approval.
- The settlement bank account (IBAN) you gave during onboarding is correct.
2. Switch keys and hosts#
| Sandbox | Live | |
|---|---|---|
| Base URL | https://sandbox.cardencer.com |
https://api.cardencer.com |
| Secret key | snd_… |
prd_… |
| Publishable key | pk_snd_… |
pk_prd_… |
- Create a live secret key in API keys and store it in your production secrets, never in code.
- Replace the sandbox base URL with
https://api.cardencer.comin your server. - Initialise the checkout SDK with your
pk_prd_key and pointcustomBackendUrlathttps://api.cardencer.com(or remove it: live is the SDK default). - Your secret key is not exposed in your website or mobile app.
Keep the configuration per environment, for example:
# .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#
- Your production endpoint is registered for live mode (see Webhooks) and served over HTTPS.
- You verify
X-Webhook-Signature-512with your live webhook signing key. - Processing is idempotent on
event_id.
4. Secure your payments#
- Before fulfilling an order, retrieve the payment from your server (
GET /payments/{payment_id}) or rely on a verified webhook. Never trust the status your frontend reports. - Check that
amountandcurrencymatch the order. - Your checkout page is served over HTTPS and loads the SDK from
https://sdk.cardencer.com.
5. Error handling#
- Your server handles every API error and shows the customer a clear message.
- Your checkout handles SDK errors and lets the customer retry with another card.
- You retry
429and5xxresponses with backoff, and never retry a payment creation without checking whether the first attempt succeeded. - You tested declines, 3D Secure, refunds and (if you use it) manual capture in the sandbox.
6. Checkout experience#
- The pay button is clearly visible.
- The checkout matches your brand (customization).
- Your return page shows the right message for
succeeded,processingand failed payments.
7. First live payment#
Make a small real payment with your own card, check it appears under Payments in the dashboard, then refund it.