Créer des URL personnalisées pré-remplies pour les codes QR

Payreq peut utiliser des URL propres à chaque client pour pré-remplir certains champs d’une page d’inscription FastForm ou d’une page de paiement. Un mailhouse ou un système de composition de documents peut transformer chaque URL en code QR et le placer sur l’avis correspondant.

Il existe deux usages courants :

Avant de construire l’un ou l’autre type, demandez à Payreq de confirmer le chemin propre au biller et le mappage des champs. Ne copiez pas la structure d’URL d’un autre biller dans un environnement de production.

Codes QR d’Abonnement numérique

L’adresse FastForm de production suit cette structure :

https://go.payreq.com/fastform/<chemin-biller>/create

Un FastForm peut prendre en charge des champs d’authentification pré-remplis. Les champs disponibles et leurs noms de paramètres dépendent de la configuration du biller.

Pour un FastForm configuré avec un champ de compte ou de référence et un champ de nom du client, la structure peut être :

https://go.payreq.com/fastform/<chemin-biller>/create?aN=<numéro-de-compte>&a1=<nom-du-client>

Dans cet exemple, aN correspond au champ de compte ou de référence et a1 correspond au champ de nom du client. Ces noms ne sont pas universels. Confirmez les paramètres réels et le mappage avec Payreq avant toute utilisation en production.

Exemple TEST

FastForm de base :

https://test.payreq.com/fastform/demo-council/create

FastForm pré-rempli :

https://test.payreq.com/fastform/demo-council/create?aN=12345&a1=Mr%20S%20Smith

Le client examine tout de même le formulaire, fournit tout autre détail requis et termine l’inscription.

Codes QR de paiement

L’adresse de production de la page de paiement suit cette structure :

https://go.payreq.com/pay/<chemin-biller>?accountNumber=<numéro-de-compte>&amount=<montant>

Les paramètres pris en charge sont :

Le montant est facultatif. Pour ne pré-remplir que la référence de compte ou de paiement, omettez le paramètre amount :

https://go.payreq.com/pay/<chemin-biller>?accountNumber=<numéro-de-compte>

Payreq traite les paiements au cent près. Si l’URL fournit plus de deux décimales, la valeur pré-remplie est arrondie au cent le plus proche. Utilisez un montant positif valide, exprimé en dollars et en cents. Les montants d’URL nuls ou négatifs ne sont pas documentés et ne doivent pas être utilisés.

Exemples TEST

Référence de compte ou de paiement seule :

https://test.payreq.com/pay/demo-council?accountNumber=1234567890

Référence de compte ou de paiement et montant :

https://test.payreq.com/pay/demo-council?accountNumber=1234567890&amount=250.75

Encoder correctement les valeurs

Appliquez l’encodage pourcentage standard des URL aux valeurs insérées dans la chaîne de requête. Par exemple :

Aucune liste de caractères propre à Payreq n’a été confirmée séparément. Testez les caractères attendus dans les références de compte réelles du biller et dans les noms de clients, dans le cadre de la mise en œuvre.

N’incluez que des informations déjà affichées sur l’avis contenant le code QR. N’ajoutez aucune information personnelle, de paiement ou de compte sans rapport à l’URL.

Construire et tester les codes QR

1. Demandez à Payreq de confirmer le bon chemin biller, le type de page et le mappage des champs.
2. Identifiez les valeurs déjà présentes dans les données de l’avis qui alimenteront l’URL.
3. Construisez l’URL à l’aide des noms de paramètres confirmés.
4. Encodez chaque valeur en pourcentage avant de l’insérer dans la chaîne de requête.
5. Générez un code QR distinct à partir de l’URL finale de chaque client.
6. Testez des exemples représentatifs avant la production.

L’ensemble de test devrait inclure :

• des valeurs de compte ou de référence typiques;
• les valeurs les plus longues attendues;
• des noms contenant des espaces et les caractères spéciaux attendus dans les données du biller;
• un montant de paiement facultatif omis;
• un montant à deux décimales; et
• un montant à plus de deux décimales, pour confirmer l’arrondi.

Pour chaque test, confirmez que le code QR ouvre la bonne page du biller et que chaque champ pré-rempli contient la valeur attendue. Le client doit toujours pouvoir examiner la page et compléter l’action requise.

Placer et étiqueter les codes clairement

Lorsqu’un avis contient plusieurs codes QR, séparez-les et étiquetez-les afin que le client puisse distinguer ce que fait chacun. Par exemple :

Testez l’avis final composé, pas seulement l’URL. Confirmez que chaque code reste lisible à la taille imprimée et n’est pas confondu avec un autre code sur la page.

Articles connexes

• Canaux d’Abonnement disponibles dans Payreq Delivery
• Aperçu des paiements
• Configuration des paiements
• Téléverser du Courrier via SFTP