Ajouter REDA Pay aux pages d’enregistrement : le bouton Pay
Le personnel encaisse les paiements depuis les enregistrements sur lesquels il travaille déjà : une piste qui postule pour un logement, un contact qui verse un dépôt, un compte qui règle une facture. REDA Pay vous offre trois façons d’ouvrir l’écran de paiement depuis une page d’enregistrement, au choix pour chaque objet. Chaque point d’entrée peut prédéfinir le profil, le compte, les moyens et les boutons que l’écran propose : le bouton de l’équipe de location et celui du service aux propriétaires peuvent ainsi se comporter différemment.
- Le Pay Profile et le Processing Account sont configurés et actifs ; consultez la Feuille de route de configuration.
- Vous avez l’autorisation Salesforce de modifier les pages Lightning (un administrateur système l’a) et REDA Pay - Admin User.
- Le personnel qui utilisera le bouton a REDA Pay - User.
Choisir un point d’entrée
| Point d’entrée | Ce que c’est | Choisissez-le lorsque |
|---|---|---|
| Composant PayButton | Un bouton de la page d’enregistrement qui ouvre l’écran de paiement en pleine page, en transmettant l’Id de l’enregistrement | Vous voulez un bouton clair et souhaitez éventuellement prédéfinir des options par l’adresse qu’il ouvre |
| Composant NewPayOrder | L’écran de paiement lui-même, placé sur la page d’enregistrement ou dans un onglet | Vous voulez l’écran intégré à la page, avec ses options définies dans le Générateur d’application Lightning |
| Un bouton personnalisé ou une action rapide qui ouvre l’adresse de l’écran | Votre propre bouton, créé dans le Gestionnaire d’objet, pointant vers l’adresse de l’écran de paiement avec des paramètres | Vous gérez déjà vos boutons ainsi, ou il vous faut l’écran sous forme d’action rapide |
Les trois ouvrent le même écran et les mêmes règles s’appliquent. La seule différence est l’endroit où se trouvent les paramètres.
Option 1 — Le bouton Pay
- Ouvrez un enregistrement de l’objet, par exemple une piste, cliquez sur l’icône d’engrenage et choisissez Modifier la page. Le Générateur d’application Lightning s’ouvre.
- Dans la liste des composants, sous Personnalisés - Géré, trouvez PayButton et faites-le glisser là où vous voulez le bouton : en haut de la page ou dans un onglet.
- Définissez ses propriétés :
| Propriété | Saisissez |
|---|---|
| Button Label | Ce que lit le personnel, par exemple Receive Payment |
| Button URL | L’adresse de l’écran de paiement : /lightning/cmp/rpay__NewPayOrder, suivie éventuellement de ? et de paramètres qui fixent le profil, le compte, les moyens ou les boutons (voir plus bas) |
| Button Variant | Le style de bouton Salesforce : brand pour un bouton principal bleu, neutral pour un bouton simple, etc. |
- Enregistrez la page, puis activez-la pour l’organisation, l’application ou les profils qui doivent la voir.
Lorsqu’on appuie dessus, le bouton ajoute l’Id de l’enregistrement à l’adresse (rpay__rid=<Id>) et ouvre l’écran. L’enregistrement devient l’enregistrement parent du paiement : REDA Pay retrouve ou crée son Pay Customer et y relie le Pay Order.
Un bouton Pay sur une piste. Un clic ouvre l’écran de paiement pour cette piste.
Prédéfinir l’écran par l’adresse
Ajoutez des paramètres au Button URL pour décider de ce que l’écran propose. Exemples :
| Button URL | Effet |
|---|---|
/lightning/cmp/rpay__NewPayOrder | Tout ce que l’utilisateur, le client et le compte autorisent |
/lightning/cmp/rpay__NewPayOrder?rpay__ttype=rcpt | Encaissements uniquement : pas de question sur le décaissement |
/lightning/cmp/rpay__NewPayOrder?rpay__ttype=rcpt&rpay__bank=0 | Encaissements par carte uniquement |
/lightning/cmp/rpay__NewPayOrder?rpay__ttype=rcpt&rpay__nosch=1&rpay__nolnk=1 | Paiement immédiat uniquement : pas de boutons Schedule ni Create Link |
/lightning/cmp/rpay__NewPayOrder?rpay__ppid=<Id du Pay Profile>&rpay__pid=<Id du Processing Account> | Saute les questions de profil et de compte |
/lightning/cmp/rpay__NewPayOrder?rpay__amount=250&rpay__fixamt=1&rpay__cnotes=Application%20fee | Un montant fixe de 250 $ avec une note : un bouton de frais de dossier |
La liste complète figure dans la Référence des paramètres d’URL. Les valeurs de l’adresse l’emportent sur les paramètres du composant lui-même.
Option 2 — L’écran de paiement sur la page
- Dans le Générateur d’application Lightning de la page d’enregistrement, faites glisser NewPayOrder (sous Personnalisés - Géré) sur la page, généralement dans un onglet dédié comme Payments, car l’écran a besoin de largeur.
- Définissez ses propriétés dans le panneau de droite : quels types de transfert, moyens et boutons autoriser, s’il faut limiter les profils et les comptes par code, les interrupteurs EMD et de frais, et jusqu’à quatre attributs à inscrire sur l’ordre. Chaque propriété est expliquée dans la Référence des paramètres des composants. Laissez Is Portal décoché sur les pages internes.
- Enregistrez et activez la page.
L’écran s’ouvre dès que l’onglet est affiché et déduit le profil, le client et le compte à partir de l’enregistrement.
Option 3 — Un bouton personnalisé ou une action rapide
Si votre équipe préfère les boutons du Gestionnaire d’objet :
- Configuration → Gestionnaire d’objet → Piste → Boutons, liens et actions → Nouveau bouton ou lien.
- Choisissez Detail Page Button (bouton de page de détail), le comportement Display in existing window (afficher dans la fenêtre existante), la source de contenu URL et la formule
/lightning/cmp/rpay__NewPayOrder?rpay__rid={!Lead.Id}avec les paramètres souhaités. - Ajoutez le bouton à la présentation de page.
Une action rapide de type Lightning Component (composant Lightning) peut aussi héberger NewPayOrder ; elle ouvre la première étape dans une boîte de dialogue, puis l’écran de paiement s’ouvre en pleine page.
Quels objets couvrir
| Objet | Usage typique | Adresse suggérée |
|---|---|---|
| Piste | Frais de dossier, dépôts de réservation | Encaissements uniquement |
| Contact | Loyers, dépôts et frais d’un résident | Encaissements uniquement |
| Compte | Factures d’une entreprise ; versements à un fournisseur ou à un propriétaire | Encaissements et décaissements ; le commutateur propre à l’utilisateur décide de ce qu’il peut faire |
| Opportunité | Acomptes sur une vente | Ajoutez rpay__oppid={!Opportunity.Id} avec le rpay__rid du contact ou du compte, pour que l’ordre soit relié à l’opportunité |
L’enregistrement parent doit être un compte, un contact ou une piste : les objets que REDA Pay sait transformer en Pay Customer. Pour une opportunité, le bouton transmet le contact ou le compte lié comme parent et l’opportunité comme lien.
Erreurs à éviter
| Erreur | Ce qui se passe | Correction |
|---|---|---|
| Button URL sans la barre oblique initiale | L’adresse ne se résout pas | Commencez par /lightning/cmp/ |
| Chercher le composant sous le nom du produit | Le Générateur d’application Lightning liste les composants gérés par leur nom : PayButton, NewPayOrder | Cherchez sous Personnalisés - Géré |
| Placer le bouton Pay sur un objet autre qu’un compte, un contact ou une piste | « Bad Request. Parent record not found. » ou « Transaction not allowed for SObject: … » | Transmettez un Id de compte, de contact ou de piste avec rpay__rid |
| Page activée pour la mauvaise application | Le personnel ne voit pas le bouton | Vérifiez l’activation (par défaut pour l’organisation, par défaut pour l’application, ou par application et profil) |
| Personnel sans REDA Pay - User | L’écran ne se charge pas | Attribuez l’ensemble d’autorisations |
Questions fréquentes
Oui : par exemple Collect Application Fee avec un montant fixe et Receive Payment sans. Chacun est son propre composant PayButton, avec sa propre adresse.
Testez-le sur les appareils de votre équipe avant de compter dessus ; l’écran de paiement est conçu pour une fenêtre de navigateur.
Non. Les libellés de l’écran sont fixes ; le libellé de bouton que vous définissez ne s’applique qu’au bouton Pay de la page.
Pour aller plus loin
- Encaisser un paiement : ce qui se passe après l’appui sur le bouton.
- Référence des paramètres des composants
- Référence des paramètres d’URL