Référence des paramètres des composants
REDA Pay fournit quelques composants que vous placez sur des pages : l’entrée de paiement (NewPayOrder), l’entrée d’enregistrement de moyen (NewPayMethod), les seconds écrans que chacune ouvre, les pages de résultat des portails et un PayButton. Chacun expose des paramètres dans le panneau de droite du Générateur d’application Lightning (pages internes) ou d’Experience Builder (pages de portail et pages publiques). Cette page liste tous les paramètres. Pour placer un composant, consultez Ajouter REDA Pay aux pages d’enregistrement et Permettre aux clients de payer dans votre portail.
Les composants apparaissent sous Personnalisés - Géré dans la liste des composants, par leur nom.
Comment les paramètres se combinent
Un paramètre de composant ne peut que restreindre ce que le Processing Account et le Pay Customer autorisent ; il ne peut pas l’étendre. Les valeurs passées dans l’adresse de la page (consultez la Référence des paramètres d’URL) l’emportent sur les paramètres du composant. Ainsi, pour toute option :
ce que l’écran propose = règles du compte ∩ règles du client ∩ paramètres du composant, les paramètres d’URL l’emportantNewPayOrder : l’entrée de paiement
| Paramètre | Par défaut | Effet |
|---|---|---|
| Enable Scheduling Order | activé | Affiche le bouton Schedule |
| Enable Order Link | activé | Affiche le bouton Create Link |
| Limit Profile Selection | vide | Des Pay Profile Codes séparés par des virgules. Vide : tous les profils actifs que l’utilisateur peut voir. Un code : ce profil est utilisé sans question |
| Limit Processing Account Selection | vide | Des Processing Account Codes séparés par des virgules, même règle |
| Allow Pay Method Type - Card | activé | Propose l’onglet Card, si le compte et le client autorisent les cartes |
| Allow Pay Method Type - Bank Account | activé | Propose l’onglet Bank, même condition |
| Allow Transfer Type - Receipt (Cash-In) | activé | Autorise les encaissements depuis cette page |
| Allow Transfer Type - Disbursement (Cash-Out) | activé | Autorise les décaissements depuis cette page (l’utilisateur a toujours besoin d’Enable Disbursements) |
| Disable EMD Payments | désactivé | Masque l’interrupteur Earnest Money Deposit |
| Do NOT Charge Convenience Fee | désactivé | Les ordres de cette page ne portent pas de frais de service |
| Attribute 1 … Attribute 4 | vide | Texte recopié sur chaque ordre créé depuis cette page, pour vos automatisations et vos rapports |
| Customer Notes | vide | Prévu pour afficher une note à l’écran. Dans cette version, ce paramètre est sans effet ; transmettez plutôt la note avec le paramètre d’URL rpay__cnotes |
| Is Portal | désactivé | À cocher sur les pages Experience Cloud. Fait passer le composant en navigation et en résolution d’enregistrement de portail |
| Portal Record Identifier | User-Contact | Dans un portail : si le Contact ou l’Account de l’utilisateur connecté est l’enregistrement parent du paiement |
| Portal Payment Page | vide | Le nom d’API de la page du portail qui contient NewPayOrderRequest |
| Portal Success Page | vide | Le nom d’API de la page qui contient NewPayOrderResult pour la réussite |
| Portal Error Page | vide | Le nom d’API de la page qui contient NewPayOrderResult pour les erreurs |
| Portal Return URL | vide | Où mènent Cancel et le Cancel du récapitulatif dans un portail ; n’importe quelle adresse, y compris votre propre site web |
| Skip Geo-Location Capture | désactivé | Ne demande pas la position au navigateur (à ne pas combiner avec un compte qui l’exige) |
Le panneau des paramètres. Chaque ligne y est expliquée dans le tableau ci-dessus.
NewPayOrderRequest : l’écran de paiement
Aucun paramètre. Placez-le sur la page du portail indiquée dans Portal Payment Page. En interne, il s’ouvre tout seul.
NewPayOrderResult : la page de résultat du portail
| Paramètre | Effet |
|---|---|
| Is Success (une seule case à cocher) | Cochez-la sur la page indiquée dans Portal Success Page ; laissez-la décochée sur la page indiquée dans Portal Error Page. Le composant affiche selon le cas « Success — Your order is successfully processed. Order Reference: P-000000 » ou « Error — Error encountered while processing order. Error Log: … » |
NewPayMethod : l’entrée d’enregistrement de moyen
| Paramètre | Par défaut | Effet |
|---|---|---|
| Limit Profile Selection | vide | Des Pay Profile Codes séparés par des virgules, comme ci-dessus |
| Default Pay Method | activé | Le moyen enregistré devient le moyen par défaut du client |
| Allow Pay Method Type - Card | activé | Propose les cartes |
| Allow Pay Method Type - Bank Account | activé | Propose les comptes bancaires |
| Allow Transfer Type - Receipt (Cash-In) | activé | Le moyen peut servir aux encaissements |
| Allow Transfer Type - Disbursement (Cash-Out) | activé | Le moyen peut servir aux décaissements |
| Customer Notes | vide | Comme ci-dessus : sans effet dans cette version ; utilisez rpay__cnotes |
| Is Portal, Portal Record Identifier | désactivé, User-Contact | Comme pour NewPayOrder |
| Portal Method Input Page | vide | Le nom d’API de la page du portail qui contient NewPayMethodRequest |
| Portal Success Page, Portal Error Page, Portal Return URL | vide | Comme pour NewPayOrder, avec NewPayMethodResult sur les pages de résultat |
| Default Currency | — | USD ou CAD, proposée comme devise d’un nouveau compte bancaire |
NewPayMethodRequest et NewPayMethodResult
NewPayMethodRequest n’a aucun paramètre. NewPayMethodResult a la même case unique que NewPayOrderResult et affiche « Your payment method is successfully processed. » ou « Error encountered while processing payment method. Error Log: … ».
PayButton : un bouton qui ouvre une adresse
| Paramètre | Obligatoire | Effet |
|---|---|---|
| Button Label | oui | Le texte du bouton |
| Button URL | oui | L’adresse à ouvrir. Sur une page d’enregistrement, l’Id de l’enregistrement est ajouté sous la forme rpay__rid=<Id> |
| Button Variant | oui | Le style de bouton Salesforce : base, neutral, brand, brand-outline, destructive, destructive-text, inverse, success |
RedirectToURL : pour les flux d’écran
Un petit composant pour vos propres flux d’écran, avec un seul paramètre, Navigation URL : lorsque le flux l’atteint, il navigue vers cette adresse. Le flux Add Pay Method de REDA Pay l’utilise pour ouvrir l’écran d’enregistrement de moyen.
Configurations types
| Page | Paramètres |
|---|---|
| Page de piste du personnel, frais de dossier par carte | Allow Bank désactivé ; Enable Scheduling Order désactivé ; Enable Order Link désactivé |
| Page de compte du personnel, encaissements et versements | Valeurs par défaut |
| Page de paiement du portail résidents, banque uniquement | Is Portal activé ; Portal Record Identifier User-Contact ; Allow Card désactivé ; Enable Order Link désactivé ; Portal Payment Page, Success Page, Error Page et Return URL définis |
| Page publique des liens de paiement | Is Portal activé ; Portal Payment Page, Success Page, Error Page et Return URL définis. Les liens portent leurs propres restrictions de moyen et de frais |
| Page d’enregistrement de moyen du portail | Is Portal activé ; Portal Method Input Page, Success Page, Error Page et Return URL définis |
Erreurs à éviter
| Erreur | Ce qui se passe | Correction |
|---|---|---|
| Is Portal laissé décoché sur une page de portail | La navigation après la première étape échoue ou revient au mauvais endroit | Cochez Is Portal et définissez les pages du portail |
| Noms des pages du portail saisis comme libellés | REDA Pay ne trouve pas la page | Utilisez le nom d’API de la page, dans les propriétés de page d’Experience Builder |
| Allow Card et Allow Bank tous deux désactivés | L’écran n’a aucun onglet | Autorisez-en au moins un |
| S’attendre à ce que Customer Notes s’affiche | Rien n’apparaît | Utilisez rpay__cnotes dans l’adresse |
| Limiter les profils par leur nom au lieu de leur code | Aucun profil ne correspond | Utilisez le Code du Pay Profile |