Personnalisation

Ce que chaque lien hérite de votre compte, et ce que chacun contrôle de son côté.

Votre marque, réglée une fois pour le compte, donne à chaque lien son logo, ses couleurs, sa police et son arrondi. Chaque lien contrôle son propre contenu : images, texte, bouton, questions, langues et personnes autorisées à l'ouvrir.

Ce qui vient du compte, une fois pour toutes

Le logo, la palette, la police, l'arrondi des angles et le mode d'apparence se trouvent dans Paramètres → Image de marque. Modifiez-les là et tous vos liens sont mis à jour d'un coup, en même temps que votre checkout hébergé et vos factures. Le tableau complet est sur Checkout hébergé, puisque c'est le même réglage qui sert les trois.

L'image de marque nécessite un plan payant

Paramètres → Image de marque dépend de la fonctionnalité Personnalisation du design, incluse à partir de Growth. Avec Pay as you go, chaque lien garde l'apparence par défaut. Servir vos liens depuis votre propre domaine plutôt que wajub.link est une fonctionnalité distincte, Domaine personnalisé, incluse à partir de Scale.

Ce qui appartient au lien

Tout ce qui suit se règle lien par lien, et deux liens d'un même compte peuvent différer sur chacun de ces points.

Images

Le poster est la bannière en haut de la page, et gallery en contient jusqu'à dix autres, affichées en dessous. Pour un produit, c'est la différence entre une page qui vend et une page qui annonce un prix.

Les deux voies n'acceptent pas la même chose. Le Dashboard téléverse des fichiers, JPEG, PNG, GIF ou WebP jusqu'à 10 Mo chacun, et les héberge pour vous. L'API prend des URLs que vous hébergez déjà, jusqu'à 2 048 caractères chacune, et ne téléverse jamais rien. Faites-les pointer vers des images que vous servez vous-même.

Le bouton, et ce qui suit le paiement

cta_type fixe le texte du bouton parmi buy_now, pay, donate, register, ou custom associé à votre propre custom_cta_text de 50 caractères maximum.

thank_you_message remplace la confirmation par défaut une fois le paiement réussi. C'est la dernière chose que lit le payeur, c'est donc le bon endroit pour un délai de livraison ou une prochaine étape.

Questions au payeur

extra_fields ajoute des champs à la page : un numéro de table, une taille, une note pour la cuisine.

Un champ a un name, en lettres minuscules, chiffres et tirets bas, un label, un type parmi text, email, tel, textarea, select et checkbox, un indicateur required, un placeholder facultatif, et pour un select ses options. Un lien accepte jusqu'à dix champs. La page demande en plus l'e-mail du payeur, toujours : un paiement sur un lien ne peut pas se faire sans.

Deux questions sur la page

{

"extra_fields": [

{

"name": "size",

"label": "Size",

"type": "select",

"required": true,

"options": [

"S",

"M",

"L"

]

{

"name": "note",

"label": "Note to the seller",

"type": "textarea",

"required": false

}

]

}

Donnez à chaque champ un name et un type. Les réponses accompagnent le paiement, imbriquées et non aplaties : lisez metadata.extra_fields.size dans votre handler de webhook, pas metadata.size.

Un lien porte jusqu'à vingt codes promo, réglés dans le Dashboard. Chacun a un code, de 3 à 32 lettres majuscules, chiffres, tirets ou tirets bas, unique parmi vos liens, une remise en pourcentage ou en montant fixe, et en option un nombre maximal d'utilisations et une date d'expiration. Le payeur saisit le code sur la page et voit la remise avant de payer.

Produits numériques

Un produit digital est livré par e-mail une fois le paiement réussi : le payeur doit donc donner une adresse e-mail. Dans le Dashboard, vous téléversez le fichier, à partir du plan Growth, ou vous donnez une URL https vers lui, sur tous les plans ; file_url sur POST /links prend une adresse à vous, pas un fichier téléversé dans le Dashboard.

Le bouton Télécharger maintenant de l'e-mail est un lien propre à ce paiement, jamais l'adresse du fichier lui-même, et la page ne montre le fichier qu'après le paiement. Le téléchargement fonctionne pendant la durée d'accès que vous fixez dans le Dashboard, ou sans limite si vous n'en fixez pas, même une fois le lien fermé ou archivé, et s'arrête quand le paiement est remboursé en totalité. Avec single_use_access: true, l'acheteur télécharge le fichier une seule fois : la page de téléchargement lui demande de le conserver, et une visite suivante indique que le téléchargement a déjà servi. C'est l'accès de l'acheteur, pas celui du lien : l'acheteur suivant peut toujours acheter, sauf si le lien est un lien à usage unique. Quand file_url est votre propre adresse, l'acheteur y est envoyé : protégez-la comme tout téléchargement.

Langues

Un lien peut être bilingue. supported_locales liste les langues que la page propose parmi fr et en, default_locale indique celle qui s'affiche en premier, et translations contient l'autre version, indexée par langue.

Le même lien, en deux langues

{

"default_locale": "fr",

"supported_locales": [

"fr",

"en"

"translations": {

"en": {

"title": "Amina Coffee, 250 g",

"description": "Roasted in Douala, ground to order.",

"custom_cta_text": "Order now",

"thank_you_message": "Thank you, we ship within 48 hours."

}

Seuls quatre champs se traduisent : title, description, custom_cta_text et thank_you_message. Les champs de base du lien sont ceux qu'affiche la langue par défaut, vous n'écrivez donc jamais que la seconde langue dans translations.

Devises

supported_currencies permet au payeur de changer de devise sur la page. La currency propre au lien est toujours proposée, et les devises que vous ajoutez viennent s'y joindre.

Qui peut entrer

Cinq verrous indépendants, et la page se ferme dès que l'un d'eux se déclenche.

Réglage	Réponse de la page
`is_public` mis à `false`	`404`, le lien n'est pas publié
`access_password`	Une demande de mot de passe avant tout affichage
`max_views` atteint	`410`, le plafond de vues est épuisé
`expiry_date` dépassée, ou `is_archived`	`410`, le lien est terminé
`single_use_link`, une fois payé	Que le lien a déjà servi à payer

Une tentative bloquée n'est pas comptée comme une vue : le verrou du mot de passe n'entame donc pas max_views.

Ce que chaque type ajoute

Le type apporte ses propres réglages, qui n'existent que sur ce type.

Type	Ce que vous pouvez régler
`product`	`product_variants`, stock, livraison, poids, et pour un service la durée, le lieu et l'URL de réunion
`event`	Types de billets avec leur propre nom, prix et quantité, `event_capacity`, `generate_qr_tickets`, `attendee_info_fields`, `refund_policy`
`fundraising`	`show_progress`, `show_contributors`, `allow_overflow`, `impact_tiers`, `campaign_deadline`, `fundraising_milestones`
`donation`	`suggested_amounts`, `allow_custom_amount`, `min_amount`, `max_amount`, `allow_anonymous`, `show_donor_wall`

L'URL de réunion d'un service n'est jamais sur la page avant le paiement : le payeur la reçoit dans l'e-mail de confirmation de son paiement, avec ce qu'il faut préparer, et la page propose de la rejoindre une fois le paiement fait.

Ce que l'API peut régler, et ce qu'elle ne peut pas

C'est ce qu'il faut savoir avant d'automatiser quoi que ce soit. L'API et le Dashboard n'atteignent pas les mêmes champs, et POST /links en atteint davantage que PUT /links/{id}.

Champ	Création via l'API	Mise à jour via l'API	Dashboard
`title`, `description`, `price`	Oui	Oui	Oui
`currency`	Oui	Non	Oui
`target_amount`, `min_amount`, `max_amount`	Oui	Oui	Oui
`callback_url`	Oui	Oui	Non
`cta_type`, `custom_cta_text`	Oui	Oui	Oui
`custom_url`, `tags`	Oui	Oui	Oui
`category_id`	Non	Non	Oui
`is_public`, `is_archived`, `expiry_date`, `sales_limit`	Oui	Oui	Oui
`accept` (moyens de paiement proposés)	Oui	Oui	Oui
`extra_fields`, `thank_you_message`	Oui	Non	Oui
`poster`, `gallery`	Oui, en URLs	Non	Oui, en fichiers téléversés
Champs propres au type, événement et collecte de fonds	Oui	Non	Oui
`supported_locales`, `default_locale`, `translations`	Non	Non	Oui
`supported_currencies`	Non	Non	Oui
`access_password`, `max_views`	Non	Non	Oui
`single_use_link`, `single_use_access`	Oui	Non	Oui
`file_url`, le fichier d'un produit numérique à votre propre adresse	Oui	Non	Oui, ou un fichier téléversé
Codes promo	Non	Non	Oui
Domaine personnalisé, types de billets	Non	Non	Oui

La mise à jour via l'API est plus restreinte que la création

PUT /links/{id} ignore les champs marqués Non dans la colonne Mise à jour via l'API, et répond tout de même 200. Modifiez-les dans le Dashboard.

Dans le Dashboard

Liens → un lien → Modifier réunit tous les réglages, avec un aperçu à côté des champs. C'est le seul endroit qui donne accès aux langues, aux devises, au mot de passe d'accès, au plafond de vues, au domaine personnalisé et aux types de billets d'un événement.

Chaque lien a aussi ses propres endpoints de webhook, distincts de ceux de votre compte, avec leur propre secret, un envoi de test et une nouvelle tentative. Utilisez-les quand une campagne doit prévenir un système que le reste de votre compte ne prévient pas. Une livraison ne compte que si l'endpoint répond par un 2xx : toute autre réponse, une redirection comprise, est enregistrée comme échouée et retentée, et une redirection n'est jamais suivie. L'envoi de test indique seulement si l'endpoint l'a accepté.

Pages associées