Liens de paiement
Créez une page de paiement Cardencer sécurisée et à vos couleurs en un seul appel API, et partagez le lien par e-mail, SMS ou messagerie.
Un lien de paiement est une page de paiement hébergée par Cardencer pour un paiement donné. Créez-le avec l'API, envoyez l'URL à votre client : il règle par carte, Apple Pay ou Google Pay. Aucun code frontend n'est nécessaire.
Usages courants :
- factures et devis envoyés par e-mail,
- commandes prises par téléphone ou par messagerie,
- social commerce et campagnes marketing,
- relances de commandes impayées, ou alternative au paiement à la livraison.
Créez un lien de paiement#
Créez un paiement avec "payment_link": true. Un lien de paiement ne peut pas être confirmé à sa création : n'envoyez donc pas "confirm": true.
curl https://sandbox.cardencer.com/payments \
-H "api-key: $CARDENCER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount": 12000,
"currency": "EUR",
"payment_link": true,
"profile_id": "pro_REPLACE_WITH_YOUR_PROFILE_ID",
"description": "Invoice 2026-118",
"return_url": "https://example.com/thanks",
"session_expiry": 86400
}'const payment = 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: 12000,
currency: "EUR",
payment_link: true,
profile_id: process.env.CARDENCER_PROFILE_ID,
description: "Invoice 2026-118",
return_url: "https://example.com/thanks",
session_expiry: 86400,
}),
}).then((r) => r.json());
console.log(payment.payment_link.link);payment = requests.post(
"https://sandbox.cardencer.com/payments",
headers={"api-key": os.environ["CARDENCER_API_KEY"]},
json={
"amount": 12000,
"currency": "EUR",
"payment_link": True,
"profile_id": os.environ["CARDENCER_PROFILE_ID"],
"description": "Invoice 2026-118",
"return_url": "https://example.com/thanks",
"session_expiry": 86400,
},
).json()
print(payment["payment_link"]["link"])La réponse contient un objet payment_link. Envoyez payment_link.link à votre client. Cardencer n'envoie ni e-mails ni SMS à votre place ; utilisez votre propre service d'e-mail ou de messagerie.
Expiration#
Par défaut, un lien est valable 15 minutes. Définissez session_expiry en secondes pour prolonger sa validité, jusqu'à 7 890 000 secondes (environ 3 mois). Une fois le lien expiré, créez un nouveau paiement.
Personnalisez la page#
Transmettez payment_link_config lors de la création du lien :
{
"amount": 12000,
"currency": "EUR",
"payment_link": true,
"profile_id": "pro_REPLACE_WITH_YOUR_PROFILE_ID",
"payment_link_config": {
"theme": "#4E6ADD",
"logo": "https://example.com/logo.png",
"seller_name": "Atelier Martin",
"sdk_layout": "accordion",
"display_sdk_only": false,
"show_card_form_by_default": true,
"payment_button_text": "Régler la facture",
"transaction_details": [
{ "key": "Facture", "value": "2026-118", "ui_configuration": { "position": 1, "is_key_bold": true } },
{ "key": "Échéance", "value": "30 nov. 2026" }
]
}
}| Champ | Effet |
|---|---|
theme |
Couleur principale, au format hexadécimal. |
logo |
URL du logo affiché dans la section de détails. |
seller_name |
Nom de votre entreprise dans la section de détails. |
transaction_details |
Lignes clé/valeur de la section de détails, triées selon ui_configuration.position. |
sdk_layout |
Disposition du formulaire de paiement : accordion ou tabs. |
display_sdk_only |
Afficher uniquement le formulaire de paiement, sans la section de détails. |
show_card_form_by_default |
Ouvrir directement le formulaire de carte. |
hide_card_nickname_field |
Masquer le champ de surnom de la carte. |
payment_button_text |
Texte du bouton de paiement. |
Suivez le paiement#
Un lien de paiement est un paiement comme les autres. Suivez-le avec les webhooks (payment_succeeded, payment_failed) ou récupérez-le avec GET /payments/{payment_id}. Les remboursements fonctionnent comme pour tout autre paiement.