Aller au contenu

Personnalisation

Adaptez le module de paiement Cardencer à votre marque : dispositions, thèmes, variables de style, règles CSS, wallets, langues et bouton de paiement.

Le formulaire de paiement est conçu pour convertir dès l'installation, mais vous gardez la main sur son apparence et son comportement. Les options d'apparence se placent dans hyper.widgets({ clientSecret, appearance }) ; les options de comportement dans widgets.create("payment", options) (ou dans la prop options de PaymentElement en React).

Dispositions#

Deux dispositions sont disponibles. La disposition par défaut est accordion.

const options = {
  layout: {
    type: "accordion",
    defaultCollapsed: false,
    radios: true,
    spacedAccordionItems: false,
  },
};

Vous pouvez aussi transmettre la disposition sous forme de chaîne : layout: "tabs".

Cartes enregistrées#

Les clients fidèles voient d'abord leurs cartes enregistrées. hideCardExpiry: true masque la date d'expiration des cartes enregistrées et affiche le champ CVC sur la même ligne :

js
const options = {
  layout: { savedMethodCustomization: { groupingBehavior: "groupByPaymentMethods", hideCardExpiry: true } },
};

Emplacement d'Apple Pay et de Google Pay#

Par défaut, les wallets en un geste s'affichent au-dessus du formulaire. Définissez displayOneClickPaymentMethodsOnTop: false pour les afficher plutôt dans la disposition :

js
const options = { layout: { type: "tabs", displayOneClickPaymentMethodsOnTop: false } };

Wallets#

js
const options = {
  wallets: {
    walletReturnUrl: "https://example.com/checkout/complete",
    applePay: "auto",
    googlePay: "auto",
    style: { theme: "dark", type: "buy", height: 48, buttonRadius: 8 },
  },
};
Option Valeurs
walletReturnUrl URL vers laquelle le client revient après un paiement par wallet. Obligatoire pour les wallets.
applePay, googlePay "auto" affiche le bouton lorsque l'appareil le prend en charge ; "never" le masque.
style.theme dark, light ou outline.
style.type Libellé du bouton : default, buy, pay, checkout, book, donate, order, subscribe, tip, etc.
style.height, style.buttonRadius Hauteur et rayon des angles, en pixels.

Thèmes et variables#

Partez d'un thème, puis surchargez les variables :

js
const appearance = {
  theme: "default", // "default", "midnight", "brutal", "charcoal", "soft" or "none"
  variables: {
    fontFamily: "Inter, system-ui, sans-serif",
    fontSizeBase: "16px",
    colorPrimary: "#4E6ADD",
    colorBackground: "#ffffff",
    colorText: "#0a0b0d",
    colorDanger: "#d92d20",
    borderRadius: "10px",
    spacingUnit: "4px",
  },
};
const widgets = hyper.widgets({ clientSecret, appearance });
Variable Contrôle
fontFamily, fontSizeBase, fontWeightNormal, fontWeightBold, fontLineHeight Typographie. Les autres tailles de police sont calculées à partir de fontSizeBase.
colorPrimary, colorPrimaryText Couleur de marque et couleur du texte affiché dessus.
colorBackground, colorText, colorTextSecondary, colorTextPlaceholder Champs, onglets et texte.
colorDanger, colorSuccess, colorWarning États.
borderRadius, spacingUnit Forme et densité.

Règles#

rules associe des sélecteurs de type CSS à des propriétés CSS (en camelCase) pour un contrôle plus fin :

js
const appearance = {
  theme: "default",
  rules: {
    ".Tab": { border: "1px solid #e4e4e7", boxShadow: "none" },
    ".Tab:hover": { borderColor: "#4E6ADD" },
    ".Input": { padding: "12px 14px" },
    ".Input--invalid": { borderColor: "#d92d20" },
    ".Label": { fontWeight: "600" },
  },
};

Les classes prises en charge incluent .Tab, .Label, .Input, .InputLogo, .TermsTextLabel, .InfoElement et .OrPayUsingLabel, avec des états comme --invalid et --empty et des pseudo-classes comme :hover et :focus.

Langues#

Le formulaire utilise la langue du navigateur du client lorsqu'elle est prise en charge, et l'anglais à défaut. Pour imposer une langue, transmettez locale :

js
const widgets = hyper.widgets({ clientSecret, appearance, locale: "fr" });

Langues prises en charge : ar, ca, de, en, en-GB, es, fr, fr-BE, he, it, ja, nl, pl, pt, ru, sv, zh.

Bouton de paiement#

Si le SDK affiche le bouton de paiement (sdkHandleConfirmPayment.handleConfirm: true), stylisez-le via appearance.variables :

Variable Contrôle
buttonBackgroundColor, buttonTextColor Couleurs.
buttonHeight, buttonWidth Dimensions.
buttonBorderRadius, buttonBorderColor, buttonBorderWidth Bordure.
buttonTextFontSize, buttonTextFontWeight Libellé.

Autres options#

js
const options = {
  branding: "never",
  paymentMethodsHeaderText: "Payer avec",
  savedPaymentMethodsHeaderText: "Vos cartes enregistrées",
  displaySavedPaymentMethods: true,
  displaySavedPaymentMethodsCheckbox: true,
  savedPaymentMethodsCheckboxCheckedByDefault: false,
  hideCardNicknameField: true,
  hideExpiredPaymentMethods: true,
  paymentMethodOrder: ["card"],
  business: { name: "Atelier Martin" },
  readOnly: false,
};
Option Effet
branding "never" masque la mention du SDK ; "always" l'affiche.
paymentMethodsHeaderText, savedPaymentMethodsHeaderText Titres des sections.
displaySavedPaymentMethods Afficher les cartes enregistrées du client.
displaySavedPaymentMethodsCheckbox Afficher la case « enregistrer la carte » (nécessaire pour enregistrer des cartes).
savedPaymentMethodsCheckboxCheckedByDefault Cocher la case par défaut.
hideCardNicknameField Masquer le champ de surnom de la carte lors de l'enregistrement.
hideExpiredPaymentMethods Masquer les cartes enregistrées expirées.
paymentMethodOrder Ordre des moyens de paiement.
business.name Nom de l'entreprise utilisé dans le texte des conditions de la carte. Par défaut, votre nom de marchand.
readOnly Désactiver toute interaction, par exemple pendant le recalcul du panier.

Message des conditions de la carte#

Remplacez ou masquez le texte affiché sous le formulaire de carte, qui sert aussi de libellé à la case « enregistrer la carte » :

js
const options = {
  paymentMethodsConfig: [
    {
      paymentMethod: "card",
      paymentMethodTypes: [
        { paymentMethodType: "credit", message: { displayMode: "custom_message", value: "Votre carte est enregistrée en toute sécurité pour votre prochaine commande." } },
        { paymentMethodType: "debit", message: { displayMode: "hidden" } },
      ],
    },
  ],
};

displayMode vaut default_sdk_message, custom_message ou hidden.