Référence des paramètres d’URL
L’entrée de paiement (NewPayOrder) et l’entrée d’enregistrement de moyen (NewPayMethod) lisent des instructions dans l’adresse avec laquelle elles sont ouvertes. C’est ainsi qu’un bouton Pay fixe le montant de frais de dossier, qu’un lien de coordonnées bancaires fournisseur sait à quel compte il appartient, et qu’une page de portail peut présélectionner un profil. Une valeur dans l’adresse l’emporte sur le même paramètre du composant ; consultez la Référence des paramètres des composants.
Avant de commencer : les paramètres s’ajoutent après ? et se séparent par &. Les valeurs contenant des espaces ou de la ponctuation doivent être encodées pour URL (un espace devient %20). Les Id d’enregistrement sont les Id Salesforce de 15 ou 18 caractères.
L’adresse de paiement interne est /lightning/cmp/rpay__NewPayOrder ; sur un site, c’est la page qui contient le composant d’entrée, par exemple https://yourcompany.my.site.com/portal/s/new-pay-order.
Paramètres de l’entrée de paiement (NewPayOrder)
Qui et où
| Paramètre | Valeur | Signification |
|---|
rpay__rid | Id d’enregistrement | L’enregistrement parent : un compte, un contact ou une piste. Sur une page d’enregistrement, le PayButton l’ajoute pour vous. Obligatoire, sauf si la page est une page de portail qui identifie l’utilisateur connecté, ou si rpay__oid est présent |
rpay__custid | Id du Pay Customer | Utilise ce Pay Customer au lieu d’en chercher un à partir de l’enregistrement parent |
rpay__ppid | Id du Pay Profile | Utilise ce profil sans question |
rpay__pid | Id du Processing Account | Utilise ce compte sans question |
rpay__pfid | Id du Processing Account | Verse les frais de service sur ce compte |
rpay__lid, rpay__cid, rpay__aid, rpay__oppid | Id de piste, de contact, de compte, d’opportunité | Relie l’ordre à ces enregistrements en plus de l’enregistrement parent |
rpay__oid | Id d’ordre chiffré | Ouvre un lien de paiement existant. REDA Pay l’intègre dans chaque Link URL ; ne le construisez jamais vous-même |
Quel type de paiement
| Paramètre | Valeur | Signification |
|---|
rpay__ttype | rcpt ou disb | Fixe le sens : encaissement ou décaissement |
rpay__otype | imm, schd ou lnk | Fixe le type d’ordre : paiement immédiat, planification ou lien de paiement |
rpay__card | 1 ou 0 | Autorise ou masque les cartes |
rpay__bank | 1 ou 0 | Autorise ou masque les comptes bancaires |
rpay__noimm | 1 | Masque le bouton Pay |
rpay__nosch | 1 | Masque le bouton Schedule |
rpay__nolnk | 1 | Masque le bouton Create Link |
rpay__noemd | 1 | Masque l’interrupteur Earnest Money Deposit |
Montant, frais et notes
| Paramètre | Valeur | Signification |
|---|
rpay__amount | Un nombre, par exemple 250 ou 1250.50 | Préremplit le montant. Une valeur qui n’est pas un nombre est ignorée |
rpay__fixamt | 1 | Le montant ne peut pas être modifié (affiché en texte). À utiliser avec rpay__amount |
rpay__nofee | 1 | Aucun frais de service sur cet ordre |
rpay__cfee | Un nombre | Remplace les frais de service calculés par ce montant |
rpay__cnotes | Texte | Customer Notes, affichées au payeur et enregistrées sur l’ordre |
rpay__att1 … rpay__att4 | Texte | Attribute 1–4 sur l’ordre, pour vos automatisations et vos rapports |
rpay__geoskip | 1 | Ne demande pas la position au navigateur |
Paramètres de l’entrée d’enregistrement de moyen (NewPayMethod)
| Paramètre | Valeur | Signification |
|---|
rpay__rid | Id d’enregistrement | L’enregistrement parent (compte, contact ou piste). Obligatoire avec rpay__custid, ou à sa place |
rpay__custid | Id du Pay Customer | Le client auquel appartient le moyen |
rpay__ppid | Id du Pay Profile | Utilise ce profil sans question |
rpay__ttype | rcpt ou disb | L’usage autorisé du moyen |
rpay__default | 1 ou 0 | Fait du moyen enregistré le moyen par défaut du client |
rpay__card, rpay__bank | 1 ou 0 | Autorise ou masque chaque type |
rpay__curr | USD ou CAD | Préremplit la devise du compte bancaire |
rpay__cnotes | Texte | Une note affichée à l’écran |
rpay__lid, rpay__cid, rpay__aid | Id | Relie le moyen à ces enregistrements |
Exemples pratiques
| Objectif | Adresse |
|---|
| Bouton de frais de dossier sur une piste : 75 $, non modifiable, carte ou banque, paiement immédiat uniquement | /lightning/cmp/rpay__NewPayOrder?rpay__amount=75&rpay__fixamt=1&rpay__ttype=rcpt&rpay__nosch=1&rpay__nolnk=1&rpay__cnotes=Application%20fee (le PayButton ajoute rpay__rid) |
| Bouton de versement sur un compte, limité à un compte de traitement | /lightning/cmp/rpay__NewPayOrder?rpay__ttype=disb&rpay__ppid=a00…&rpay__pid=a01… |
| Adresse pour créer uniquement un lien de paiement, sans frais, banque uniquement | /lightning/cmp/rpay__NewPayOrder?rpay__rid=003…&rpay__otype=lnk&rpay__nofee=1&rpay__card=0 |
| Lien de coordonnées bancaires fournisseur sur votre site public | https://yourcompany.my.site.com/public/s/process-method-link?rpay__rid=001…&rpay__ttype=disb&rpay__default=1&rpay__card=0 |
| Page de portail qui présélectionne un profil pour tous les résidents | Mettez rpay__ppid=a00… dans l’adresse utilisée par la navigation du portail, ou définissez Limit Profile Selection sur le composant |
Une formule de bouton personnalisé sur Piste se lit par exemple :
/lightning/cmp/rpay__NewPayOrder?rpay__rid={!Lead.Id}&rpay__amount=75&rpay__fixamt=1&rpay__ttype=rcpt
Règles de priorité
- Une valeur d’URL l’emporte sur le paramètre du composant pour la même option.
- Ni l’une ni l’autre ne peut proposer plus que ce que le Processing Account et le Pay Customer autorisent ; elles ne font que retirer des options.
- Un profil ou un compte transmis par Id doit être actif et cohérent avec l’autre ; sinon, l’écran ne peut pas les utiliser.
rpay__oid (un lien de paiement) prend le dessus : le montant, le choix des frais et les restrictions de moyen de l’ordre lui-même s’appliquent, et seul Pay est disponible.
Erreurs à éviter
| Erreur | Ce qui se passe | Correction |
|---|
Oublier rpay__rid sur un lien de moyen | « Bad Request. Parent record not found. » | Ajoutez l’Id du compte, du contact ou de la piste |
rpay__amount=100e ou $100 | Le montant est ignoré et reste modifiable | Uniquement des chiffres et un point décimal |
rpay__fixamt=1 sans montant | Rien à fixer ; le payeur saisit le montant | Ajoutez rpay__amount |
Transmettre le Code d’un Pay Profile dans rpay__ppid | Introuvable | rpay__ppid attend l’Id d’enregistrement ; les codes vont dans le Limit Profile Selection du composant |
Pour aller plus loin
