Feuille de route de configuration : de l’installation au premier paiement
Cette page est la carte. Elle liste chaque étape de configuration dans l’ordre où REDA Pay en a besoin, indique pourquoi chacune compte et renvoie à l’article qui la détaille. Les étapes 1 à 8 vous mènent à un premier paiement encaissé par votre équipe dans Salesforce. Les étapes 9 à 12 ajoutent les autres canaux et les tâches d’arrière-plan.
- REDA Pay est installé dans votre organisation (Configuration → Packages installés affiche REDA Pay). Votre responsable de compte REDA ou support@reda.one vous fournit le lien d’installation de votre édition.
- Vous avez un compte Payload et pouvez vous connecter à son tableau de bord pour copier une clé API.
- Vous avez l’ensemble d’autorisations REDA Pay - Admin User ; consultez Qui peut faire quoi.
Partie 1 — Relier Salesforce à Payload
1. Générer la clé de chiffrement
REDA Pay chiffre chaque secret qu’il stocke (votre clé API Payload, les identifiants Payload, les identifiants des liens de paiement) avec une clé qui n’existe que dans votre organisation. Tant que la clé n’existe pas, REDA Pay ne peut pas fonctionner et affiche « REDA Pay setting(s) are invalid or not defined. Please contact your system administrator. »
Ouvrez l’application REDA Pay → onglet REDA Pay Admin → Encryption Key Setup → Generate Key. La clé ne peut être générée qu’une fois ; le bouton affiche ensuite Generated. → Générer la clé de chiffrement
L’onglet REDA Pay Admin. L’étape 1 se fait sur la première carte ; l’étape 11 sur la seconde.
2. Créer un Pay Profile et enregistrer la clé API Payload
Un Pay Profile relie Salesforce à un compte Payload. Créez-le dans l’onglet Pay Profiles avec un nom, un Pay Profile Code unique et Provider = Payload, en laissant Is Active décoché. Appuyez ensuite sur Update API Token sur le profil et collez la clé API de votre tableau de bord Payload. Ne saisissez jamais la clé directement dans le champ API Token : c’est le bouton qui la chiffre. → Créer un Pay Profile et enregistrer votre clé API Payload
3. Synchroniser les comptes de traitement et activer le profil
Appuyez sur Sync Processing Accounts sur le Pay Profile. REDA Pay lit vos comptes commerçants chez Payload, crée un Processing Account pour chacun et renseigne le Profile Id du profil. Cochez ensuite Is Active sur le profil : REDA Pay refuse d’activer un profil tant qu’il n’a pas à la fois le jeton API et le Profile Id. → Synchroniser les comptes de traitement et activer le profil
Partie 2 — Décider comment l’argent circule
4. Configurer chaque compte de traitement
Ouvrez chaque Processing Account et définissez au moins Is Active, Allowed Transfer Type (Receipt, Disbursement, ou Receipt and Disbursement) et Allowed Pay Methods (Card, Bank Account (ACH), ou les deux). Un Allowed Pay Methods vide signifie qu’aucun moyen de paiement ne peut être utilisé. Profitez-en pour définir le logo, l’en-tête et le pied de page que verront vos payeurs, ainsi que l’onglet par défaut (carte ou banque). Sur le Pay Profile, choisissez un Default Processing Account pour que le personnel n’ait pas à en choisir un à chaque fois. → Configurer un compte de traitement · Personnaliser l’écran de paiement à votre image
5. Ajouter des frais de service (facultatif)
Si vous répercutez les coûts de traitement sur les payeurs, ajoutez des enregistrements Fee Setup sous le Processing Account : un pour les paiements bancaires, et un pour toutes les cartes ou par marque de carte. Sans Fee Setup, les ordres ne portent aucun frais. → Configurer les frais de service
6. Vérifier la création des clients
La première fois qu’une personne paie depuis un compte, un contact ou une piste, REDA Pay crée un Pay Customer à partir de cet enregistrement, à l’aide d’enregistrements de correspondance fournis avec le package pour ces trois objets. Vérifiez-les avant la mise en production : ils déterminent le nom, l’e-mail, le téléphone et les moyens de paiement autorisés du client. → Comment les Pay Customers sont créés
Partie 3 — Permettre à votre équipe d’encaisser
7. Attribuer les ensembles d’autorisations
Donnez aux administrateurs REDA Pay - Admin User, au personnel REDA Pay - User, au service des remboursements REDA Pay - Transaction Manager, et à la finance REDA Pay - Reconciliation Manager avec REDA Pay - Read Only User. Si quelqu’un doit effectuer des versements, cochez REDA Pay - Enable Disbursements sur son enregistrement utilisateur. → Qui peut faire quoi : ensembles d’autorisations
8. Placer l’écran de paiement là où travaille le personnel
Ajoutez le composant de paiement REDA Pay ou un bouton Pay aux pages d’enregistrement qu’utilise votre équipe, généralement Piste, Contact et Compte. Encaissez ensuite un petit paiement de test. → Ajouter REDA Pay aux pages d’enregistrement · Encaisser un paiement
À ce stade, le personnel peut encaisser des paiements. Les statuts ne se mettront pas à jour automatiquement avant la fin de l’étape 9.
Partie 4 — Automatisation et autres canaux
9. Configurer les webhooks
Payload informe Salesforce lorsqu’un paiement est traité, refusé, remboursé ou rejeté, et lorsque des dépôts arrivent sur votre compte bancaire. Pour cela, Payload a besoin d’une adresse Salesforce publique à appeler. Créez (ou réutilisez) un site public, donnez à son utilisateur invité l’accès au rappel REDA Pay, saisissez l’adresse du site dans Webhook API Base URL sur le Pay Profile et appuyez sur Setup Webhooks. Setup Webhooks supprime d’abord tous les webhooks enregistrés sous cette clé API Payload : si la même clé sert un autre système, lisez l’article avant d’appuyer. → Configurer les webhooks
10. Liens de paiement et portail client
- Les liens de paiement nécessitent un site public avec les pages REDA Pay, l’ensemble d’autorisations REDA Pay - Public Site User pour son utilisateur invité et deux paramètres sur le Processing Account : Link Site Public URL et Link Expiration (Minutes). Renseignez les deux : un lien créé alors que Link Expiration est vide n’est jamais actif. → Configurer le site public des liens de paiement · Accès invité aux liens de paiement : autorisations et partage
- Les paiements dans le portail nécessitent les pages REDA Pay dans votre portail Experience Cloud et REDA Pay - Community User pour les utilisateurs du portail. → Permettre aux clients de payer dans votre portail · Accès au portail : autorisations et partage pour les clients
11. Activer les tâches d’arrière-plan
- Les paiements récurrents ne s’exécutent que si la tâche quotidienne est planifiée : Configuration → Classes Apex → Planifier Apex, classe
SchedulePayOrderJob, tous les jours. → Planifier la tâche quotidienne des paiements récurrents - La récupération des paiements échoués vérifie toutes les 15 minutes les paiements dont le résultat est inconnu parce que la connexion à Payload a été interrompue. Activez le commutateur Sync Failed Pay Order Transactions dans l’onglet REDA Pay Admin. → Activer la récupération des paiements échoués
12. Préparer la production
- Désactivez le détail technique dans les erreurs affichées, pour que les payeurs voient un message simple plutôt qu’une trace de pile. → Paramètres d’organisation et messages d’erreur
- Testez avec chaque rôle, pas en tant qu’administrateur : un collaborateur, un client du portail et un payeur anonyme qui ouvre un lien.
Liste de contrôle
| # | Étape | Terminée quand |
|---|---|---|
| 1 | Clé de chiffrement | Le bouton de l’onglet Admin affiche Generated |
| 2 | Pay Profile + clé API | Le profil existe et Update API Token a réussi |
| 3 | Synchronisation + activation | Les Processing Accounts apparaissent sous le profil et Is Active est coché |
| 4 | Comptes de traitement | Chaque compte actif a ses types de transfert et ses moyens de paiement définis |
| 5 | Frais (facultatif) | Des Fee Setups existent pour les moyens sur lesquels vous appliquez des frais |
| 6 | Correspondance des clients | Enregistrements de correspondance vérifiés pour Compte, Contact et Piste |
| 7 | Ensembles d’autorisations | Chaque utilisateur a le bon ensemble ; les utilisateurs qui versent ont Enable Disbursements |
| 8 | Pages d’enregistrement | Un paiement de test depuis une piste affiche une Pay Transaction traitée |
| 9 | Webhooks | L’onglet Webhook Setup du profil liste les webhooks enregistrés |
| 10 | Liens / portail | Un lien de test s’ouvre sur votre site public ; un utilisateur du portail peut payer |
| 11 | Tâches | La tâche quotidienne apparaît dans la page Toutes les tâches prévues de la Configuration ; le commutateur de récupération est activé |
| 12 | Production | Traces de pile désactivées ; chaque rôle testé |
Questions fréquentes
Oui. Le paiement est traité et enregistré. Les changements ultérieurs (un paiement bancaire rejeté quelques jours plus tard, un dépôt qui arrive sur votre compte) n’arrivent dans Salesforce qu’une fois les webhooks configurés, ou lorsque quelqu’un appuie sur Sync Transaction.
Non. REDA Pay fournit le paramètre de site distant nécessaire pour l’API de Payload.
Non. Elle est générée une fois par organisation, et tout ce que REDA Pay chiffre en dépend.
Pour aller plus loin
- Générer la clé de chiffrement : l’étape 1.
- Concepts clés et terminologie : si un terme ci-dessus ne vous est pas familier.