Comment les Pay Customers sont créés à partir des comptes, contacts et pistes
Un Pay Customer est la personne ou l’entreprise auprès de laquelle REDA Pay encaisse de l’argent ou qu’il paie, telle que la connaît un Pay Profile. Votre équipe ne remplit jamais de formulaire Pay Customer avant d’encaisser un paiement : la première fois que l’écran de paiement s’ouvre depuis un compte, un contact ou une piste (l’enregistrement parent), REDA Pay crée automatiquement le Pay Customer à partir de celui-ci, selon une correspondance que vous pouvez lire et modifier. Cet article explique cette correspondance, ce qui se passe lors des paiements suivants et comment le client reste synchronisé avec Payload.
Ce qui se passe la première fois
- Un collaborateur appuie sur le bouton Pay d’un contact, ou un client ouvre la page de paiement dans votre portail.
- REDA Pay cherche un Pay Customer pour cet enregistrement parent sur le Pay Profile choisi.
- S’il n’en existe aucun, il lit l’enregistrement REDA Pay Process Config de l’objet parent (Account, Contact ou Lead), construit le Pay Customer à partir des champs que cet enregistrement fait correspondre, puis l’enregistre.
- Dès lors, chaque paiement depuis cet enregistrement utilise le même Pay Customer. Lorsque le client paie pour la première fois, REDA Pay l’enregistre aussi chez Payload et stocke l’identifiant client de Payload (chiffré) sur l’enregistrement.
Un Pay Customer garde un lien vers son compte, son contact ou sa piste, et Parent Record Id contient l’Id de l’enregistrement d’origine.
Un Pay Customer créé à partir d’une piste. L’Allowed Transfer Type et l’Allowed Payment Methods proviennent de la correspondance.
Les enregistrements de correspondance
Ouvrez Configuration → Types de métadonnées personnalisées → REDA Pay Process Config → Gérer les enregistrements (Manage Records). Trois enregistrements sont fournis avec le package, un par objet parent :
| Enregistrement | Source Object API Name | Correspondance |
|---|---|---|
| Account - Config - Payload | Account | Nom à partir du nom du compte ; Allowed Transfer Type Receipt and Disbursement ; Allowed Payment Methods Card et Bank Account ; le lien vers le compte |
| Contact - Config - Payload | Contact | Nom, e-mail et téléphone (à partir du téléphone mobile du contact) ; le même type de transfert et les mêmes moyens ; le lien vers le contact |
| Lead - Config - Payload | Lead | Nom, e-mail et téléphone (à partir du téléphone mobile de la piste) ; idem ; le lien vers la piste |
Chaque enregistrement a ces champs :
| Champ | Signification |
|---|---|
| Source Object API Name | L’objet parent auquel s’applique l’enregistrement, par exemple Contact |
| Is Active | Seuls les enregistrements actifs sont utilisés. S’il n’existe aucun enregistrement actif pour un objet, les paiements depuis cet objet s’arrêtent avec « Transaction not allowed for SObject: … » |
| Applicable To User Profiles | Facultatif : des noms de profils Salesforce séparés par des virgules. Une fois renseigné, l’enregistrement ne s’applique qu’aux utilisateurs ayant ces profils, et il est préféré à un enregistrement dont le champ est vide. Permet à un profil de portail d’avoir une correspondance différente de celle du personnel |
| Customer Record Mapping | Une ligne par champ du Pay Customer, sous la forme FieldApiName=valeur. Une valeur écrite {{FieldName}} est copiée depuis l’enregistrement parent (un chemin comme {{Account.Name}} est permis) ; toute autre valeur est utilisée telle quelle |
| Pay Profiles | Indiqué comme obligatoire dans le texte d’aide, mais non utilisé par les écrans de paiement : laissez-le tel quel |
| Description | Notes internes |
La correspondance Contact fournie se lit ainsi :
Name={{Name}}
rpay__Email__c={{Email}}
rpay__Phone__c={{MobilePhone}}
rpay__Allowed_Transfer_Type__c=two-way
rpay__Allowed_Payment_Methods__c=card;bank_account
rpay__Contact__c={{Id}}two-way est la valeur enregistrée pour Receipt and Disbursement ; send-only correspond à Receipt et receive-only à Disbursement. card et bank_account sont les valeurs enregistrées pour les deux moyens de paiement.
Modifier la correspondance
Modifications courantes, chacune faite en modifiant l’enregistrement et ses lignes Customer Record Mapping :
| Objectif | Modification |
|---|---|
| Les clients créés à partir de contacts peuvent seulement payer, jamais être payés | rpay__Allowed_Transfer_Type__c=send-only dans l’enregistrement Contact |
| Les résidents du portail ne peuvent payer que par compte bancaire | Créez un second enregistrement Contact, renseignez Applicable To User Profiles avec le nom du profil du portail et faites correspondre rpay__Allowed_Payment_Methods__c=bank_account |
| Utiliser le téléphone professionnel du contact plutôt que le mobile | rpay__Phone__c={{Phone}} |
| Reporter votre propre référence sur le client | rpay__Attribute_1__c={{Your_Field__c}} |
Enregistrez, puis testez en encaissant un paiement depuis un enregistrement qui n’a pas encore de Pay Customer. Une correspondance vers un champ qui n’existe pas sur le Pay Customer, ou une valeur que le champ ne peut pas accepter, échoue à cette étape avec l’erreur affichée à l’écran.
Les trois enregistrements de correspondance fournis. Modifiez-les sur place ; ajoutez un second enregistrement pour un objet seulement si un profil a besoin de règles différentes.
Un client par enregistrement, profil et e-mail
REDA Pay fournit une règle de doublon sur Pay Customer qui bloque un second enregistrement ayant le même Parent Record Id, le même Pay Profile et le même Email. Un contact a donc un Pay Customer par Pay Profile. Deux contacts différents avec le même e-mail sont des clients différents, car leurs enregistrements parents diffèrent. Si vous devez fusionner deux contacts, faites-le avant d’encaisser des paiements, ou attendez-vous à deux Pay Customers.
Conversion des pistes
Lorsqu’une piste qui a des Pay Customers est convertie, REDA Pay déplace ses Pay Customers vers le nouveau compte et le nouveau contact, et ses Pay Orders vers la nouvelle opportunité : l’historique des paiements suit la personne. Le lien du Pay Customer vers la piste est remplacé par les liens vers le contact et le compte.
Garder le client synchronisé avec Payload
Payload conserve sa propre copie du nom, de l’e-mail et du téléphone du client. REDA Pay lui transmet les modifications :
- Au premier paiement : le client est enregistré automatiquement chez Payload.
- Sur l’enregistrement : le bouton Create Payload Customer d’un Pay Customer l’enregistre (ou renvoie ses données) sans encaisser de paiement.
- À la modification : modifier le nom, l’e-mail ou le téléphone du Pay Customer envoie la modification à Payload en arrière-plan. En cas d’échec, la raison apparaît dans Sync Error Message sur l’enregistrement ; corrigez les données et appuyez sur Create Payload Customer.
Un client sans Email peut quand même payer : l’écran de paiement demande une adresse e-mail et l’enregistre sur l’ordre.
Erreurs à éviter
| Erreur | Ce qui se passe | Correction |
|---|---|---|
| Désactiver l’enregistrement Lead parce que les pistes ne doivent pas payer | Tout paiement depuis une piste s’arrête avec « Transaction not allowed for SObject: Lead » | Ne le désactivez délibérément que si aucune page de piste ne porte de bouton Pay |
| Faire correspondre un champ qui n’existe pas | La création du client échoue avec une erreur « Invalid field » à l’écran | Vérifiez le nom d’API du champ sur l’objet Pay Customer |
| Faire correspondre Allowed Payment Methods à rien | Le client ne peut ni payer ni être payé | Faites correspondre au moins un moyen |
| Modifier l’e-mail du Pay Customer pour un e-mail déjà utilisé pour le même enregistrement et le même profil | La règle de doublon bloque l’enregistrement | Corrigez l’e-mail sur l’un des enregistrements |
| S’attendre à ce que l’adresse de l’enregistrement parent apparaisse sur le client | Seuls les champs mis en correspondance sont copiés | Ajoutez les lignes d’adresse à la correspondance si vous en avez besoin |
Questions fréquentes
Les écrans les créent un par un. Pour une migration, votre administrateur Salesforce ou REDA peut les créer par un chargement de données ou un script qui suit la même correspondance, puis les enregistrer chez Payload.
Deux Pay Profiles actifs ont été utilisés. Chaque profil garde ses propres clients.
Non. La correspondance n’est utilisée qu’à la création du Pay Customer. Mettez aussi à jour l’e-mail du Pay Customer ; cette modification est envoyée à Payload.