REDA Pay
Winter 2026 · v1.57000
5 nov. 2026
API Payload v2, saisie sécurisée des cartes sur tous les sites, et guides de configuration pour chaque canal
REDA Pay 1.57000 est une version principale. Elle rassemble tout ce qui a été livré depuis la version principale 1.56 : les correctifs 1.56001, 1.56002, 1.56003 et 1.56004 (3 et 4 novembre 2026). Une organisation qui exécute déjà la 1.56004 a chaque changement de cette page. Cette page vous dit comment installer REDA Pay pour la première fois, comment mettre à niveau une organisation qui exécute la 1.56 ou l’un des correctifs, quelles étapes la mise à niveau ne peut pas faire pour vous, et ce qui a changé, dans les mots que votre équipe utilisera.
Informations de version. Package : REDA Pay · Numéro de version : 1.57000 · Nom de version : Winter 2026.
Mettre à niveau maintenant — production · Installer dans une sandbox
Liens d’installation. La version 1.57000 a été publiée le 5 novembre 2026 et ne demande aucun mot de passe d’installation ; la connexion Salesforce, les licences du package et les autorisations s’appliquent toujours. Les liens identifient la version du package, pas une organisation en particulier : votre connexion Salesforce décide où elle s’installe. Pour voir quelle version une organisation exécute aujourd’hui : Configuration → Packages installés → REDA Pay → Numéro de version.
Vous préférez que nous le fassions ? L’équipe REDA installe, met à niveau et configure REDA Pay pour vous. Écrivez à sales@reda.one pour réserver une session.
Sur cette page
- En bref : qui doit faire quoi
- Installer REDA Pay pour la première fois
- Après l’installation : configurer chaque canal de paiement
- Mettre à niveau depuis la 1.56 ou un correctif
- Après la mise à niveau : les étapes que la mise à niveau ne peut pas faire pour vous
- Vérifier que tout fonctionne
- Nouveautés de cette version
- Corrigé dans cette version
- Nouveaux champs, actions et composants, et qui peut les voir
En bref : qui doit faire quoi
| Votre situation | Que faire | Où |
|---|---|---|
| REDA Pay n’est pas encore installé | Installez le package, puis suivez la feuille de route de configuration : clé de chiffrement, Pay Profile et clé API, comptes de traitement, ensembles d’autorisations, webhooks, et les canaux que vous utilisez (écrans du personnel, portail client, liens de paiement publics, paiements planifiés). | Installer et Après l’installation |
| Votre organisation exécute la 1.56 | Mettez à niveau, puis accomplissez chaque étape d’Après la mise à niveau : les nouveaux champs et la nouvelle action du Pay Profile sur vos présentations, l’accès pour vos propres profils ou ensembles d’autorisations clonés, l’accès invité du site de webhooks, les valeurs de jeu de valeurs, et la republication de chaque site Experience Cloud qui héberge des écrans REDA Pay. | Mettre à niveau |
| Votre organisation exécute la 1.56001, 1.56002 ou 1.56003 | Mettez à niveau, puis republiez chaque site Experience Cloud qui héberge les écrans v2 et vérifiez les autres étapes d’Après la mise à niveau — la plupart ont déjà été faites à l’installation du correctif. | Mettre à niveau |
| Votre organisation exécute la 1.56004 | Elle a déjà chaque changement de cette page. Si vous n’avez pas accompli Après la mise à niveau, faites-le maintenant ; aucune republication n’est nécessaire. | Après la mise à niveau |
| Vous voulez utiliser l’API v2 de Payload (saisie sécurisée des cartes, écrans sur un site LWR, webhooks signés) | Réglez Version de l'API Payload sur v2 sur le Pay Profile et lancez Configurer les webhooks. Rien d’autre ne bouge ; la bascule est réversible. | Choisir la version de l’API Payload |
| Votre portail client ou votre site public est un site LWR | Placez les composants v2 sur ses pages (les composants classiques ne fonctionnent pas sur LWR). Noms de page, accès invité et partage sont décrits pas à pas. | Portail · Liens publics |
| Vos utilisateurs travaillent en espagnol, en français ou en portugais (Brésil) | Rien : après la mise à niveau, REDA Pay apparaît dans la langue de l’utilisateur. Vérifiez la langue sur l’enregistrement utilisateur s’il affiche encore l’anglais. | Nouveautés |
Installer REDA Pay pour la première fois
Il vous faut un administrateur Salesforce (le profil Administrateur système, ou un profil avec Télécharger des packages AppExchange et Personnaliser l’application) et un compte Payload au tableau de bord duquel vous pouvez vous connecter. Installez d’abord dans une sandbox si vous en avez une.
- Ouvrez le lien d’installation de l’environnement dans lequel vous installez (production ou sandbox). Si vous ne l’avez pas, demandez-le à votre chargé de compte REDA ou à support@reda.one.
- Connectez-vous en tant qu’administrateur de cette organisation. Si vous avez plusieurs organisations, vérifiez le nom de l’organisation en haut de la page avant de continuer.
- Sur la page d’installation, confirmez le nom du package REDA Pay et le numéro de version par rapport à cette page.
- Choisissez Installer pour les administrateurs uniquement. L’accès pour tous les autres est accordé ensuite par les ensembles d’autorisations REDA Pay, pas par ce choix.
- Cliquez sur Installer. Si Salesforce indique que l’installation se poursuit en arrière-plan, attendez son e-mail avant de continuer.
- Ouvrez Configuration → Packages installés et confirmez que REDA Pay est listé avec ce numéro de version.
L’installation est la première de douze étapes. Le reste est dans la section suivante.
Après l’installation : configurer chaque canal de paiement
Suivez la Feuille de route de configuration : de l’installation au premier paiement depuis l’étape 1. En résumé :
| Étape | Ce qu’elle fait | Guide |
|---|---|---|
| 1. Ensembles d’autorisations | Donnez à l’administrateur REDA Pay - Admin User ; plus tard, donnez au personnel REDA Pay - User et ainsi de suite. | Qui peut faire quoi |
| 2. Clé de chiffrement | Générez la clé qui chiffre votre clé API Payload et vos identifiants. Une fois par organisation. | Générer la clé de chiffrement |
| 3. Pay Profile et clé API | Créez le profil, enregistrez la clé API Payload avec Mettre à jour le jeton d'API, et choisissez la Version de l'API Payload, v1 ou v2. | Créer un Pay Profile · Choisir la version de l’API |
| 4. Comptes de traitement | Synchronisez vos comptes marchands depuis Payload, activez le profil, configurez chaque compte (types de transfert, moyens, image de marque, frais, paramètres de liens). | Synchroniser et activer · Configurer |
| 5. Webhooks | Un site Salesforce public que Payload appelle, l’accès de son utilisateur invité, et Configurer les webhooks. En v2, un secret de signature. | Configurer les webhooks |
| 6. Paiements par le personnel | Placez l’écran de paiement sur les pages Lead, Contact et Account ; encaissez un paiement de test. | Ajouter REDA Pay aux pages d’enregistrement · Encaisser un paiement |
| 7. Portail client | Pages, paramètres des composants, ensemble d’autorisations, ensemble de partage et accès externe par défaut pour un portail à connexion — Aura ou LWR. | Permettre aux clients de payer dans votre portail · Accès au portail |
| 8. Liens de paiement publics | Pages publiques, noms d’API exacts des pages, l’ensemble d’autorisations et l’accès Apex de l’utilisateur invité, les quatre règles de partage pour les invités (avec l’option des enregistrements détenus par les utilisateurs du portail), la préférence d’API publiques, et les paramètres de liens du compte de traitement. | Configurer le site public · Accès invité |
| 9. Paiements planifiés et récupération | Planifiez la tâche quotidienne et activez la récupération des paiements échoués. | Tâche quotidienne · Récupération |
Mettre à niveau depuis la 1.56 ou un correctif
- Notez la version qu’exécute l’organisation : Configuration → Packages installés → REDA Pay → Numéro de version.
- Mettez d’abord à niveau une sandbox. Ouvrez le lien d’installation en étant connecté à la sandbox, gardez Installer pour les administrateurs uniquement, cliquez sur Mettre à niveau et attendez l’e-mail de confirmation.
- Accomplissez Après la mise à niveau dans la sandbox, exécutez les vérifications de Vérifier que tout fonctionne, puis répétez les deux en production.
Vos données, votre configuration, votre clé de chiffrement, vos webhooks et vos tâches planifiées survivent à la mise à niveau. La procédure complète, avec ce qui survit et ce qu’il faut revérifier, est dans Mettre à niveau REDA Pay.
Après la mise à niveau : les étapes que la mise à niveau ne peut pas faire pour vous
Une mise à niveau de package géré installe de nouveaux composants mais ne modifie jamais une présentation de page que vous utilisez, n’accorde jamais d’accès à vos propres profils ou ensembles d’autorisations, n’ajoute jamais une valeur à un jeu de valeurs que votre organisation a déjà, et ne republie jamais un site Experience Cloud. Faites ceci à la main, dans cet ordre. Chaque ligne dit à qui elle s’applique.
| Étape | S’applique à | Que faire |
|---|---|---|
| 1. Ajouter les nouveaux champs et la nouvelle action du Pay Profile à vos présentations | Toute organisation mise à niveau depuis la 1.56 | Sur chaque présentation de page Pay Profile en service, ajoutez les champs Version de l'API Payload (Payload API Version), Secret de signature du webhook (Webhook Signing Secret) et Apparence du paiement (Payment Appearance) — section Information pour le premier, API Setup pour le deuxième et External Labels pour le troisième, comme sur la présentation du package — et l’action Mettre à jour le secret du webhook (Update Webhook Secret). Étapes clic par clic : Mettre à niveau REDA Pay. |
| 2. Accorder les nouvelles classes et la nouvelle page à vos propres profils ou ensembles d’autorisations clonés | Les organisations qui n’attribuent pas les ensembles d’autorisations REDA Pay du package | Payeurs (personnel, utilisateurs du portail, utilisateur invité du site public) : classes Apex rpay.PayloadV2SecureCapture et rpay.PayloadSecureFieldsController, page Visualforce rpay.PayloadSecureFields. Administrateurs : classe rpay.UpdateWebhookSecretController et accès en modification aux trois nouveaux champs. Les ensembles d’autorisations du package portent déjà tout cela. Étapes : Mettre à niveau REDA Pay. |
| 3. Donner à l’utilisateur invité du site de webhooks la classe de rappel v2 | Toute organisation qui utilisera l’API Payload v2 | Sur le profil invité du site de webhooks, activez rpay.PayloadCallbackV2 à côté de rpay.PayloadCallback. Réglez ensuite le profil sur v2 et lancez Configurer les webhooks. Étapes : Configurer les webhooks. |
| 4. Republier chaque site Experience Cloud qui héberge des écrans REDA Pay | Toute organisation mise à niveau depuis la 1.56001, 1.56002 ou 1.56003, et toute organisation qui place les composants v2 | Un site LWR continue de servir le code de composants de la version précédente tant que vous ne le republiez pas : ouvrez le site dans Experience Builder et cliquez sur Publier. Examinez d’abord les modifications non publiées du site, car publier les met aussi en ligne. Publiez les sites un à la fois. |
| 5. Ajouter les valeurs de jeu de valeurs qui manquent à votre organisation | Les organisations mises à niveau depuis la 1.56 qui paient ou encaissent en réaux brésiliens ou en pesos colombiens, ou qui ont des adresses en Colombie | Les valeurs BRL et COP (Account Currency) et CO (Country) ont été ajoutées après la 1.56 et ne sont pas ajoutées à une organisation existante. Ajoutez-les dans Configuration → Jeux de valeurs de liste de sélection, en saisissant exactement ces noms d’API. Étapes : Mettre à niveau REDA Pay. |
| 6. Vérifier vos propres copies des pages d’enregistrement REDA Pay | Les organisations qui ont cloné une page d’enregistrement Lightning REDA Pay | Les pages d’enregistrement du package prennent maintenant les titres de leurs onglets dans des étiquettes traduisibles. Une page que vous avez clonée garde les titres que vous avez saisis ; ressaisissez-les avec les étiquettes si vous voulez qu’ils soient traduits. |
| 7. Décider de Create Missing Transactions | Toutes les organisations | Les nouvelles installations reçoivent CREATE_MISSING_TRANSACTIONS = TRUE ; une mise à niveau garde votre valeur. Lisez Paramètres d’organisation et messages d’erreur et réglez-le délibérément. |
Vérifier que tout fonctionne
- Configuration → Packages installés affiche REDA Pay 1.57000.
- Ouvrez un Pay Profile : les trois nouveaux champs et l’action Mettre à jour le secret du webhook sont sur la page.
- En tant qu’utilisateur interne n’ayant que REDA Pay - User, encaissez un petit paiement de test depuis un Lead sur l’environnement de test de Payload. Sur un profil v2, les informations de carte et de banque se saisissent dans le formulaire sécurisé et un message de progression apparaît pendant le paiement.
- Si vous utilisez un portail, connectez-vous en tant que client de test (Se connecter à Experience en tant qu’utilisateur sur son Contact) et atteignez l’écran de paiement.
- Si vous utilisez des liens de paiement, créez un lien de test et ouvrez-le dans une fenêtre de navigation privée : l’écran de paiement s’ouvre, et le récapitulatif affiche le numéro de l’ordre et les montants.
- Ouvrez l’onglet Configuration des webhooks du Pay Profile : dix lignes en v1, onze en v2, chacune avec un Webhook Id.
- Réglez la langue d’un utilisateur de test sur espagnol, français ou portugais (Brésil) et ouvrez une Pay Order : onglets, champs et boutons apparaissent dans cette langue.
- Ouvrez REDA Pay Logs : aucune nouvelle entrée Attention Needed.
Nouveautés de cette version
| Changement | Ce que votre équipe remarquera | Configuration ou vérification |
|---|---|---|
| 1. API Payload v2, choisie par Pay Profile | Un nouveau champ Version de l'API Payload sur le Pay Profile. Vide ou v1 garde tout exactement comme avant. v2 bascule ce profil sur l’API actuelle de Payload : les mêmes boutons, planifications et rapports, avec les nouveaux écrans ci-dessous. v1 et v2 partagent les enregistrements, les identifiants et la clé API, donc la bascule ne déplace aucune donnée et est réversible. | Placez le champ sur vos présentations ; réglez-le sur v2 quand vous êtes prêt ; lancez Configurer les webhooks. Choisir la version de l’API Payload |
| 2. Informations de carte et de banque saisies dans le formulaire sécurisé de Payload | Sur un profil v2, le numéro de carte, le code de sécurité et le numéro de compte se saisissent dans un formulaire que Payload sert dans l’écran de paiement. Ils ne transitent jamais par Salesforce. Si une extension de navigateur le bloque, l’écran le signale après dix secondes. | Rien à configurer. Si vos propres profils ou ensembles d’autorisations sont en service, accordez la page et les classes à l’étape 2. |
| 3. Nouveaux écrans de paiement et de moyen de paiement, pour tous les types de site | Six composants — REDA Pay - New Pay Order (v2), Pay Order Request (v2), Pay Order Result (v2), New Pay Method (v2), Pay Method Request (v2), Pay Method Result (v2) — avec les mêmes paramètres, paramètres d’URL, validations et règles de boutons que les écrans classiques, dans une mise en page pensée pour le téléphone avec des vignettes de moyens et une carte de résultat. Ils peuvent être placés sur des sites LWR, ce que les écrans classiques ne peuvent pas. Dans Salesforce, le bouton de paiement classique ouvre de lui-même l’écran v2 quand le profil est en v2. | Portails et sites publics en v2 : placez les composants v2 et renseignez exactement les noms de page. Portail · Liens publics · Paramètres des composants |
| 4. Webhooks signés et l’action Mettre à jour le secret du webhook | En v2, Payload signe chaque envoi de webhook avec un secret que vous définissez par Mettre à jour le secret du webhook sur le Pay Profile, et REDA Pay vérifie la signature. Configurer les webhooks sur un profil v2 ne supprime que les webhooks de ce profil et en enregistre onze (les dix de la v1, avec credit remplacé par payout et withdraw ajouté). | Ajoutez l’action à vos présentations ; activez rpay.PayloadCallbackV2 pour l’utilisateur invité du site de webhooks. Configurer les webhooks |
| 5. Apparence du paiement | Les écrans v2 suivent par défaut le thème de votre Salesforce ou de votre site. Un nouveau champ Apparence du paiement sur le Pay Profile, et les paramètres Brand Colour, Text Colour, Background Colour et Font Family sur les composants v2, vous laissent définir vos propres couleurs et police. | Facultatif. Personnaliser l’écran de paiement à votre image |
| 6. Messages de progression | Pendant un paiement v2, l’écran montre ce qu’il fait — Préparation du paiement…, Sécurisation de vos données de paiement…, Préparation de votre paiement…, Traitement de votre paiement… Cela peut prendre quelques secondes. Gardez cette fenêtre ouverte. — au lieu d’un indicateur de chargement. Les écrans de moyen font de même. | Rien. |
| 7. Espagnol, français et portugais (Brésil) | Chaque étiquette, champ, texte d’aide, valeur de liste de sélection, section de présentation, message de validation, onglet et bouton de REDA Pay est traduit. Un utilisateur dont la langue est l’une d’elles voit REDA Pay dans cette langue. | Vérifiez la Langue de l’utilisateur sur l’enregistrement utilisateur. Les traductions s’appliquent aux pages du package ; une page d’enregistrement que vous avez clonée garde vos titres (étape 6). |
| 8. Créer un lien toujours proposé | Le bouton Créer un lien ne disparaît plus quand un compte de traitement n’est pas configuré pour les liens. Appuyer dessus affiche alors : « Les liens de paiement ne sont pas configurés pour ce compte de traitement : le champ URL publique du site des liens est vide. Demandez à votre administrateur de le renseigner. » | Renseignez URL publique du site des liens sur les comptes qui émettent des liens. Configurer le site public |
| 9. Refund et Void expliquent le règlement | Sur un profil v2, Refund sur un paiement non réglé se ferme avec : « Ce paiement n'a pas encore été réglé : il ne peut pas être remboursé. Annulez-le plutôt, ou remboursez-le une fois réglé (en général avant la fin du jour ouvré). » Void sur un paiement réglé dit : « Ce paiement a déjà été réglé : il ne peut plus être annulé. Remboursez-le plutôt. » (v1 et v2). | Prévenez votre service des remboursements. Annuler ou rembourser un paiement |
| 10. Tout le texte des écrans vient d’étiquettes traduisibles | Chaque message, bouton et titre d’onglet des écrans classiques et v2, des pages d’enregistrement et des flux REDA Pay vient d’une étiquette. Les balises techniques comme « [Transfer Type] » n’apparaissent plus dans les messages, et les écrans des flux n’affichent plus un nom interne comme titre. | Rien. |
| 11. Noms de flux plus simples | Les flux du package portent des noms et des descriptions clairs, de sorte qu’un administrateur qui ouvre Configuration → Flux voit ce que fait chacun. | Si vous remplacez un flux REDA Pay, comparez-le à la nouvelle version. |
| 12. Create Missing Transactions activé par défaut pour les nouvelles installations | Une nouvelle installation rapproche les dépôts même quand une Pay Transaction manque dans Salesforce, en la créant. Les mises à niveau gardent votre réglage actuel. | Étape 7. |
Corrigé dans cette version
| Correction | Ce qui n’allait pas | Maintenant |
|---|---|---|
| Les autres liens d’un client restent ouverts | Quand l’un des liens de paiement d’un client était payé, révoqué ou expiré, les autres liens ouverts du client pouvaient cesser de s’ouvrir (« Invalid request: Bad request Parameters. »). | Les autres liens continuent de fonctionner. Un client touché avant la mise à niveau est réparé à la prochaine sauvegarde de l’un de ses ordres de lien ouverts. |
| Formulaire sécurisé sur les sites LWR | Sur un site LWR, le formulaire v2 de carte et de banque ne pouvait pas se charger (livré en 1.56001, corrigé en 1.56002). | Le formulaire se charge sur les sites LWR et Aura et dans Salesforce. |
| Récapitulatif sur les sites LWR | Le numéro d’ordre et les montants du récapitulatif v2 passaient à la ligne un caractère à la fois sur un site LWR. | Ils se lisent normalement. |
| Pages de résultat | Les pages de résultat v2 affichaient la boîte de message classique au lieu de la carte de résultat qu’affiche l’écran de paiement. | Elles affichent la même carte de résultat. |
Nouveaux champs, actions et composants, et qui peut les voir
Les trois nouveaux champs sont sur Pay Profile. Les ensembles d’autorisations du package qui lisent Pay Profile les lisent ; REDA Pay - Admin User les modifie. Si vous utilisez vos propres profils ou ensembles d’autorisations, accordez l’accès vous-même (Après la mise à niveau, étape 2).
| Champ ou action | Où sur la présentation du package | Qui le saisit | À quoi il sert |
|---|---|---|---|
| Version de l'API Payload (liste de sélection : v1, v2) | Section Information | Administrateur | Vide ou v1 : comme avant. v2 : ce profil utilise l’API v2 de Payload. Lancez Configurer les webhooks après l’avoir changé. |
| Secret de signature du webhook | Section API Setup | Personne ne le saisit : défini par l’action Mettre à jour le secret du webhook | Jusqu’à 64 caractères que Payload utilise pour signer les envois de webhook v2. Vide : les envois sont acceptés sans vérification de signature. |
| Apparence du paiement | Section External Labels | Administrateur, facultatif | Couleurs et police des écrans v2, par exemple {"brandColor":"#006B63"}. Vide : le thème hôte. |
| Mettre à jour le secret du webhook (action) | Actions du Pay Profile, à côté de Mettre à jour le jeton d'API | Administrateur | Ouvre une boîte pour définir le secret de signature ; lancez ensuite Configurer les webhooks. |
| Six composants v2 | Générateur d’application Lightning et Experience Builder, sous Personnalisé - Géré, nommés REDA Pay - … (v2) | L’administrateur les place | Les écrans v2 de paiement et de moyen de paiement pour les pages et les sites. Référence des paramètres des composants |
Aucun nouvel objet, onglet, ensemble d’autorisations ou page d’enregistrement n’est ajouté. Les valeurs de jeu de valeurs BRL, COP et CO sont nouvelles pour les organisations mises à niveau depuis la 1.56 (étape 5).