Concepts clés et terminologie
Tous les articles REDA Pay utilisent un petit nombre de termes. Chacun correspond à un type d’enregistrement que vous verrez comme onglet dans l’application REDA Pay (ouvrez le Lanceur d’application, la grille de neuf points en haut à gauche de Salesforce, et recherchez REDA Pay). Cet article explique à quoi sert chacun et comment ils sont liés, à partir d’un exemple suivi : Meridian Properties, un gestionnaire immobilier qui encaisse des loyers et des dépôts.
L’application REDA Pay. Chacun des concepts ci-dessous a son propre onglet.
Les enregistrements de configuration
Ils sont créés une fois par un administrateur et changent ensuite rarement.
Pay Profile
Un Pay Profile (profil de paiement) relie Salesforce à un compte Payload. Il contient la clé API Payload (stockée chiffrée et saisie uniquement via le bouton Update API Token) et l’adresse que Payload utilise pour renvoyer les mises à jour de statut. Une organisation peut avoir plusieurs Pay Profiles, par exemple un par société ou par marque. Chaque profil a un Pay Profile Code court et unique, qui sert à limiter les profils proposés par un écran de paiement.
Exemple : Meridian Properties a un Pay Profile, nommé « Meridian Properties », relié à son compte Payload.
Processing Account
Un Processing Account (compte de traitement) est un compte commerçant chez Payload : le compte sur lequel les paiements sont versés et depuis lequel partent les versements. Vous ne créez pas de Processing Account à la main : le bouton Sync Processing Accounts du Pay Profile les lit chez Payload. Vous configurez ensuite chacun dans Salesforce : s’il accepte les encaissements, les décaissements ou les deux ; quels moyens de paiement il accepte ; sa devise ; la durée de validité d’un lien de paiement ; et le logo, l’en-tête et le pied de page que voit le payeur. La plupart de vos règles se trouvent ici ; consultez Configurer un compte de traitement.
Exemple : « Meridian Operating Account » reçoit les loyers ; « Meridian Fee Account » reçoit les frais de service.
Fee Setup
Un Fee Setup est une règle de frais de service rattachée à un Processing Account, par exemple « 3 % sur toutes les cartes » ou « 1,75 $ par paiement bancaire ». Les frais s’ajoutent au montant du paiement et peuvent être versés sur un autre Processing Account ; consultez Configurer les frais de service.
Les enregistrements créés au fil du travail
Pay Customer
Un Pay Customer est la personne ou l’entreprise auprès de laquelle vous encaissez de l’argent ou que vous payez, telle que la connaît un Pay Profile. Vous en créez rarement un à la main : la première fois que vous ouvrez l’écran de paiement depuis un compte, un contact ou une piste, REDA Pay crée le Pay Customer à partir de cet enregistrement. L’enregistrement de départ s’appelle l’enregistrement parent, et le Pay Customer garde un lien vers lui. Un Pay Customer peut porter ses propres règles, par exemple les moyens de paiement qu’il peut utiliser ; consultez Comment les Pay Customers sont créés.
Pay Method
Un Pay Method est une carte ou un compte bancaire appartenant à un Pay Customer. Une fois enregistré chez Payload, son nom devient la description fournie par Payload, par exemple « Visa x-4242 » ou « Checking x-7890 ». Salesforce stocke un jeton et des informations descriptives, jamais le numéro de carte complet, le code de sécurité ni le numéro de compte bancaire. Un moyen peut être le moyen par défaut du client et peut être enregistré pour être réutilisé (Keep Active) ou utilisé une seule fois.
Pay Order
Un Pay Order est l’instruction de mouvement d’argent : qui, combien, depuis quel Processing Account, avec quel Pay Method. Les Pay Orders sont numérotés P-000000. Deux paramètres définissent chaque ordre :
| Paramètre | Valeurs | Signification |
|---|---|---|
| Transfer Type | Receipt · Disbursement | Un encaissement (receipt) fait entrer de l’argent ; un décaissement (disbursement) en fait sortir (comptes bancaires uniquement) |
| Order Type | Immediate · Schedule · Link | Immediate est traité tout de suite ; Schedule se répète selon une planification ; Link crée un lien de paiement que le client ouvre |
Le champ Status combine les deux, par exemple Immediate - Processed, Schedule - Active ou Link - Active. Statuts des ordres et des transactions liste toutes les valeurs.
Exemple : l’ordre P-051847 demande 1 250,00 $ de loyer sur le compte courant d’un résident ; avec les frais bancaires de 1,75 $, le Net Order Amount (le montant réellement débité) est de 1 251,75 $.
Pay Transaction
Une Pay Transaction est ce que Payload a fait d’un Pay Order. Les transactions sont numérotées T-0000000 et se trouvent sous leur ordre. Un ordre peut en avoir plusieurs : une tentative échouée, puis un paiement réussi, puis un remboursement. Chaque transaction a un Type (payment, refund, credit), un Status (par exemple processed, declined, voided, rejected ou refunded) et un Funding Status (statut de financement, par exemple pending ou batched).
Statement Activity
Une Statement Activity (activité de relevé) est un dépôt sur votre compte bancaire, ou un versement depuis ce compte, tel que le signale Payload. Ses Transaction Activities listent les paiements individuels contenus dans le dépôt, ce qui permet à la finance de rattacher chaque dépôt aux paiements correspondants ; consultez Rapprocher les dépôts et les versements.
REDA Pay Log
Un REDA Pay Log consigne une tâche d’arrière-plan qui a rencontré une erreur, avec les échecs joints dans un fichier. Les administrateurs reçoivent un e-mail à chaque création ; consultez Quand un paiement échoue.
Comment ils sont liés
Pay Profile ── Processing Account ── Fee Setup
│
├── Pay Customer ── Pay Method
│ │ │
│ └──── Pay Order ────── Pay Transaction
│
└── Statement Activity ── Transaction Activity ──→ Pay TransactionUn Pay Customer, un Pay Method et un Pay Order sont aussi reliés au compte, au contact ou à la piste dont ils proviennent, et un Pay Order peut être relié à une opportunité : les paiements apparaissent ainsi sur les enregistrements que votre équipe utilise déjà.
Trois autres termes que vous rencontrerez
| Terme | Signification |
|---|---|
| Type d’utilisateur | REDA Pay consigne qui a traité chaque ordre : Internal (un utilisateur Salesforce), Community (un utilisateur connecté au portail) ou Guest (un visiteur anonyme de votre site public). Plusieurs règles, comme la géolocalisation et les dépôts de garantie, peuvent être activées par type d’utilisateur |
| Dépôt de garantie (EMD) | Un indicateur sur un encaissement bancaire qui le marque comme dépôt de bonne foi ; consultez Encaisser des dépôts de garantie (EMD) |
| Webhook | Le message que Payload envoie à Salesforce lorsque le statut d’un paiement change. REDA Pay s’en sert pour mettre à jour les Pay Transactions automatiquement ; consultez Configurer les webhooks |
Erreurs à éviter
| Erreur | Ce qui se passe | Faites plutôt ceci |
|---|---|---|
| Créer un Processing Account à la main | Il n’est relié à aucun compte Payload et ne peut pas encaisser de paiements | Utilisez Sync Processing Accounts sur le Pay Profile |
| Saisir la clé API dans le champ API Token | La valeur n’est pas chiffrée et REDA Pay ne peut pas la lire | Utilisez le bouton Update API Token |
| Laisser Allowed Pay Methods vide sur un Processing Account ou un Pay Customer | Aucun moyen de paiement ne peut être utilisé | Choisissez Card, Bank Account (ACH) ou les deux |
| Prendre le Principal Amount pour le montant débité | Le payeur est débité du Net Order Amount, qui inclut les frais | Lisez le Net Order Amount lors du rapprochement |
Questions fréquentes
Le Pay Order est votre instruction ; la Pay Transaction est le résultat chez Payload. Un ordre qui a échoué une fois puis réussi a deux transactions : une failed et une processed.
Le Pay Customer contient ce dont Payload a besoin (son identifiant client, les moyens de paiement autorisés et le moyen par défaut) pour un Pay Profile donné. Si vous utilisez deux Pay Profiles, un même contact peut avoir deux Pay Customers.
Ce compte peut à la fois recevoir des paiements et effectuer des versements. Un Pay Order est toujours l’un ou l’autre.
Pour aller plus loin
- Qui peut faire quoi : ensembles d’autorisations : donner à chaque rôle le bon accès.
- Feuille de route de configuration : les étapes jusqu’à votre premier paiement.