Aller au contenu

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
  }'

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 :

json
{
  "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.