Ticket de confirmation
Contents
Présentation Générale
Fonctionnalités
Notre système peut envoyer une confirmation de paiement par e-mail ou SMS à votre client, lui indiquant le statut de la transaction (accepté ou refusé) à la fin du processus de transaction.
Le service de notification de confirmation du paiement au client comprend les caractéristiques suivantes :
- technologies de notification utilisées : e-mail et SMS
- notifications disponibles pour un paiement accepté (code de réponse Mercanet 00) ou un paiement refusé (code de réponse Mercanet 05)
- notifications disponibles pour toutes les cartes de paiement
- les messages envoyés peuvent être multilingues
- contenu des messages comprenant des balises remplacées par les valeurs correspondantes
- personnalisation des e-mails et SMS à l'aide de fichier de modèle (.html ou .txt)
Les applications client du service Ticket de confirmation sont :
- Mercanet Essentiel
- Mercanet Gestion Plus
Flux de notification
Étape 1 : Lorsque l'internaute effectue l'étape de paiement, une demande de paiement doit être envoyée aux pages de paiement Mercanet. Au terme du processus de paiement, que celui-ci ait été accepté ou refusé, deux réponses sont créées et envoyées aux URL de réponse fournies au cours du flux 1.
Étape 2 : Les réponses manuelles sont envoyées par le serveur de paiement à l'URL de réponse normale fournie pendant la demande de paiement lorsque l'internaute clique sur "Revenir au magasin" sur la page de paiement. Il n'est pas garanti que l'internaute cliquera sur ce lien, et il n'existe donc aucune garantie que la réponse manuelle sera reçue.
Étape 2’ : Les réponses automatiques sont envoyées séparément des réponses manuelles via l'URL de réponse automatique, fournie dans ce cas lors de la demande de paiement. Cela signifie que le marchant recevra toujours cette réponse dès que le paiement sera terminé sur les pages de paiement Mercanet.
Étape 3 : Les confirmations de paiement par e-mail ou par SMS sont envoyées par notre service Ticket de confirmation à l'acheteur (ainsi qu'au marchand en copie carbone) si l'option correspondante est activée.
Conditions d'utilisation de l'option SEND_MESSAGE
Configuration de l'option
Pour utiliser le service Ticket de confirmation avec une confirmation de paiement au client, le marchand doit souscrire à l'option.
Cette option peut être configurée à deux niveaux :
- au niveau de l'offre
- au niveau du marchand (surcharger la configuration au niveau de l'offre)
Les paramètres de configuration permettent les choix suivants :
- envoyer une confirmation de paiement en cas de paiement accepté (si le paramètre SEND ACCEPTED est activé)
- envoyer une confirmation de paiement en cas de paiement refusé (si le paramètre SEND REFUSED est activé)
- envoyer une confirmation de paiement par e-mail (si le paramètre SEND MAIL est activé)
- envoyer une confirmation de paiement par SMS (si le paramètre SEND SMS est activé)
- indiquer l'adresse e-mail de l'émetteur (avec le paramètre MAIL FROM rempli)
- indiquer l'e-mail en copie carbone "cc" (avec le paramètre MAIL CC rempli)
- indiquer le nom de fichier modèle utilisé pour les e-mails (avec le paramètre MAIL TEMPLATE rempli)
- indiquer le nom de fichier modèle utilisé pour les SMS (avec le paramètre MAIL TEMPLATE rempli)
- indiquer l'objet de l'e-mail en cas de paiement accepté (avec le paramètre MAIL SUBJECT IF ACCEPTED rempli)
- indiquer l'objet de l'e-mail en cas de paiement refusé (avec le paramètre MAIL SUBJECT IF REFUSED rempli)
Champs requis pour la demande du marchand
Les champs suivants sont obligatoires pour le bon fonctionnement des services Ticket de confirmation :
- "customerEmail" ou "customerPhone" sont nécessaires pour déterminer le mode de notification à utiliser (e-mail ou SMS). Si les deux champs sont renseignés sur la demande, l'e-mail a la priorité.
- "merchantId" au format numérique (15 chiffres).
- "amount" (montant) de la transaction.
- "currencyCode" est nécessaire pour définir l'affichage correct du montant. Code numérique ISO-4217 (3 chiffres).
Personnaliser les fichiers modèles
Modèle d'e-mail
Le contenu, la mise en page et le ton de l'e-mail sont personnalisables par l'intermédiaire d'un fichier de modèle html.
En pratique, une variable déclarée avec la syntaxe "__FIELD_NAME__" est remplacée par la valeur de votre choix (Voir le chapitre Dictionnaire de balises ci-dessous pour connaître les balises existantes).
Le design du modèle par défaut de l'offre Mercanet ressemble aux exemples suivants :
Exemples de codes HTML
La balise permet d'indiquer l'objet de l'e-mail.
La balise permet de remplacer toutes les variables avec la syntaxe "__FIELD_NAME__" par les valeurs de votre choix.
La balise html <img src=”cid:myPicture.jpg” /> permet d'afficher votre logo personnel.
Les extensions prises en charge sont les suivantes :
- jpg
- png
- gif
- bmp
Exemple HTML Accepté
<!DOCTYPE html> <!-- ATOS +com.atosworldline.sips.sipsmsg.push.sendMessage.tools.tags.SipsMsgTags.mailSubject --> Confirmation de paiement <!-- ATOS -com.atosworldline.sips.sipsmsg.push.sendMessage.tools.tags.SipsMsgTags.mailSubject --> <!-- ATOS +com.atosworldline.sips.sipsmsg.push.sendMessage.tools.tags.SipsMsgTags.language --> en <!-- ATOS -com.atosworldline.sips.sipsmsg.push.sendMessage.tools.tags.SipsMsgTags.language --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Confirmation de paiement</title> </head> <!-- ATOS +net.atos.mm.fwk.wpm.media.DefaultTags.displayProperties --> <body style="text-align:center; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px;"> <table cellspacing="0" cellpadding="0" align="center" style="width:100%; border:0px"> <tr> <td align="center"> <table cellspacing="0" cellpadding="0" align="center" style="width:602px; border:1px solid gainsboro;"> <tr id="mail_header"> <td align="center"> <table cellspacing="0" cellpadding="0" align="center" style="width:600px; height:80px;"> <tr> <td style="text-align:left; width:300px; height:80px;"><img src="cid:worldline.jpg" alt="Worldline"/></td> <td style="text-align:left; width:200px; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px;"> <div style="font-size:16px; font-weight:bold; color:#046380;margin-right:5px">Confirmation de paiement</div> <div>Shop __MERCHANT_NAME__<br/>__PAYMENT_DATE__</div> </td> </tr> </table> </td> </tr> <tr id="mail_separator_1"> <td> <hr style="height:3px; border:0px; background-color:#9D9D9D; color:#9D9D9D;"/> </td> </tr> <tr id="mail_body"> <td align="center"> <table cellspacing="0" cellpadding="0" align="center" style="width:580px; line-height:160%;"> <tr> <td align="center"> <table cellspacing="0" cellpadding="0" align="center" style="width:580px; margin-left:30px;"> <tr> <td style="text-align:left; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px;"> Bonjour, </td> </tr> <tr> <td style="height:10px;"/> </tr> <tr> <td style="text-align:left; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px;"> Votre transaction a été acceptée et enregistrée.<br/> Vous trouverez ci-dessous des informations supplémentaires concernant votre achat. </td> </tr> <tr> <td style="height:10px;"/> </tr> <tr> <td style="text-align:left; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px;"> Cordialement, l'équipe __MERCHANT_NAME__ </td> </tr> </table> </td> </tr> <tr> <td style="height:20px;"/> </tr> <tr> <td align="center"> <table cellspacing="0" cellpadding="0" align="center" style="width:560px; border:1px solid gainsboro; border-color:#93BCDA;"> <tr> <td style="height:60px; text-align:center; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:14px; font-weight:bold; color:#046380;"> PAIEMENT<br/>PAR INTERNET SÉCURISÉ </td> </tr> <tr> <td align="center"> <table cellspacing="0" cellpadding="0" align="center" style="width:500px;"> <tr> <td style="width:248px; text-align:right; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px;">Nom du marchand :</td> <td style="width:4px;"/> <td style="width:248px; text-align:left; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px; font-weight:bold;">__MERCHANT_NAME__</td> </tr> <tr> <td colspan="3" style="height:5px;"/> </tr> <tr> <td style="width:248px; text-align:right; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px;">Identifiant du marchand :</td> <td style="width:4px;"/> <td style="width:248px; text-align:left; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px; font-weight:bold;">__MERCHANT_ID__</td> </tr> <tr> <td colspan="3" style="height:5px;"/> </tr> <tr> <td style="width:248px; text-align:right; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px;">Le :</td> <td style="width:4px;"/> <td style="width:248px; text-align:left; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px; font-weight:bold;">__PAYMENT_DATE__ à __PAYMENT_TIME__</td> </tr> <tr> <td colspan="3" style="height:5px;"/> </tr> <tr> <td style="width:248px; text-align:right; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px;">Numéro de transaction :</td> <td style="width:4px;"/> <td style="width:248px; text-align:left; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px; font-weight:bold;">__TRANSACTION_ID__</td> </tr> <tr> <td colspan="3" style="height:5px;"/> </tr> <tr> <td style="width:248px; text-align:right; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px;">Numéro d'autorisation :</td> <td style="width:4px;"/> <td style="width:248px; text-align:left; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px; font-weight:bold;">__AUTHORISATION_ID__</td> </tr> <tr> <td colspan="3" style="height:5px;"/> </tr> <tr> <td style="width:248px; text-align:right; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px;">Montant :</td> <td style="width:4px;"/> <td style="width:248px; text-align:left; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px; font-weight:bold;">__AMOUNT__</td> </tr> <tr> <td colspan="3" style="height:5px;"/> </tr> <tr> <td style="width:248px; text-align:right; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px;">Moyen de paiement utilisé :</td> <td style="width:4px;"/> <td style="width:248px; text-align:left; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px; font-weight:bold;">__CARD_TYPE__</td> </tr> <tr> <td colspan="3" style="height:5px;"/> </tr> <tr> <td style="width:248px; text-align:right; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px;">Numéro de carte :</td> <td style="width:4px;"/> <td style="width:248px; text-align:left; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px; font-weight:bold;">__CARD_NUMBER__</td> </tr> <tr> <td colspan="3" style="height:5px;"/> </tr> <tr> <td style="width:248px; text-align:right; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px;">Statut de la transaction :</td> <td style="width:4px;"/> <td style="width:248px; text-align:left; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px; font-weight:bold;">Approuvé</td> </tr> </table> </td> </tr> <tr> <td style="height:40px; text-align:center; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px; font-weight:bold;"> VEUILLEZ CONSERVER VOTRE REÇU POUR RÉFÉRENCE </td> </tr> </table> </td> </tr> </table> </td> </tr> <tr> <td style="height:10px;"/> </tr> <tr id="mail_separator_2"> <td> <hr style="height:3px; border:0px; background-color:#9D9D9D; color:#9D9D9D;"/> </td> </tr> <tr id="mail_footer"> <td align="center"> <table cellspacing="0" cellpadding="0" align="center" style="width:580px;"> <tr> <td style="height:30px; text-align:right; vertical-align:top; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:11px; color:#9d9d9d;"> © Worldline </td> </tr> </table> </td> </tr> </table> </td> </tr> </table> </body> <!-- ATOS -net.atos.mm.fwk.wpm.media.DefaultTags.displayProperties --> </html>
Exemple HTML Refusé
<!DOCTYPE html> <!-- ATOS +com.atosworldline.sips.sipsmsg.push.sendMessage.tools.tags.SipsMsgTags.mailSubject --> Paiement refusé <!-- ATOS -com.atosworldline.sips.sipsmsg.push.sendMessage.tools.tags.SipsMsgTags.mailSubject --> <!-- ATOS +com.atosworldline.sips.sipsmsg.push.sendMessage.tools.tags.SipsMsgTags.language --> en <!-- ATOS -com.atosworldline.sips.sipsmsg.push.sendMessage.tools.tags.SipsMsgTags.language --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Paiement refusé</title> </head> <!-- ATOS +net.atos.mm.fwk.wpm.media.DefaultTags.displayProperties --> <body style="text-align:center; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px;"> <table cellspacing="0" cellpadding="0" align="center" style="width:100%; border:0px"> <tr> <td align="center"> <table cellspacing="0" cellpadding="0" align="center" style="width:602px; border:1px solid gainsboro;"> <tr id="mail_header"> <td align="center"> <table cellspacing="0" cellpadding="0" align="center" style="width:600px; height:80px;"> <tr> <td style="text-align:left; width:300px; height:80px;"><img src="cid:worldline.jpg" alt="Worldline"/></td> <td style="text-align:left; width:200px; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px;"> <div style="font-size:16px; font-weight:bold; color:#046380;margin-right:5px">Paiement refusé</div> <div>Shop __MERCHANT_NAME__<br/>__PAYMENT_DATE__</div> </td> </tr> </table> </td> </tr> <tr id="mail_separator_1"> <td> <hr style="height:3px; border:0px; background-color:#9D9D9D; color:#9D9D9D;"/> </td> </tr> <tr id="mail_body"> <td align="center"> <table cellspacing="0" cellpadding="0" align="center" style="width:580px; line-height:160%;"> <tr> <td align="center"> <table cellspacing="0" cellpadding="0" align="center" style="width:580px; margin-left:30px;"> <tr> <td style="text-align:left; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px;"> Bonjour, </td> </tr> <tr> <td style="height:10px;"/> </tr> <tr> <td style="text-align:left; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px;"> Votre transaction a échoué.<br/> Vous trouverez ci-dessous les informations relatives à votre demande. </td> </tr> <tr> <td style="height:10px;"/> </tr> <tr> <td style="text-align:left; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px;"> Cordialement, l'équipe __MERCHANT_NAME__ </td> </tr> </table> </td> </tr> <tr> <td style="height:20px;"/> </tr> <tr> <td align="center"> <table cellspacing="0" cellpadding="0" align="center" style="width:560px; border:1px solid gainsboro; border-color:#93BCDA;"> <tr> <td style="height:60px; text-align:center; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:14px; font-weight:bold; color:#046380;"> PAIEMENT<br/>PAR INTERNET SÉCURISÉ </td> </tr> <tr> <td align="center"> <table cellspacing="0" cellpadding="0" align="center" style="width:500px;"> <tr> <td style="width:248px; text-align:right; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px;">Nom du marchand :</td> <td style="width:4px;"/> <td style="width:248px; text-align:left; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px; font-weight:bold;">__MERCHANT_NAME__</td> </tr> <tr> <td colspan="3" style="height:5px;"/> </tr> <tr> <td style="width:248px; text-align:right; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px;">Identifiant du marchand :</td> <td style="width:4px;"/> <td style="width:248px; text-align:left; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px; font-weight:bold;">__MERCHANT_ID__</td> </tr> <tr> <td colspan="3" style="height:5px;"/> </tr> <tr> <td style="width:248px; text-align:right; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px;">Le :</td> <td style="width:4px;"/> <td style="width:248px; text-align:left; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px; font-weight:bold;">__PAYMENT_DATE__ à __PAYMENT_TIME__</td> </tr> <tr> <td colspan="3" style="height:5px;"/> </tr> <tr> <td style="width:248px; text-align:right; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px;">Numéro de transaction :</td> <td style="width:4px;"/> <td style="width:248px; text-align:left; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px; font-weight:bold;">__TRANSACTION_ID__</td> </tr> <tr> <td colspan="3" style="height:5px;"/> </tr> <tr> <td style="width:248px; text-align:right; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px;">Montant :</td> <td style="width:4px;"/> <td style="width:248px; text-align:left; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px; font-weight:bold;">__AMOUNT__</td> </tr> <tr> <td colspan="3" style="height:5px;"/> </tr> <tr> <td style="width:248px; text-align:right; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px;">Moyen de paiement utilisé :</td> <td style="width:4px;"/> <td style="width:248px; text-align:left; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px; font-weight:bold;">__CARD_TYPE__</td> </tr> <tr> <td colspan="3" style="height:5px;"/> </tr> <tr> <td style="width:248px; text-align:right; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px;">Numéro de carte :</td> <td style="width:4px;"/> <td style="width:248px; text-align:left; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px; font-weight:bold;">__CARD_NUMBER__</td> </tr> <tr> <td colspan="3" style="height:5px;"/> </tr> <tr> <td style="width:248px; text-align:right; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px;">Statut de la transaction :</td> <td style="width:4px;"/> <td style="width:248px; text-align:left; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px; font-weight:bold;">Refusé</td> </tr> </table> </td> </tr> <tr> <td style="height:40px; text-align:center; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:12px; font-weight:bold;"> VEUILLEZ CONSERVER VOTRE REÇU POUR RÉFÉRENCE </td> </tr> </table> </td> </tr> </table> </td> </tr> <tr> <td style="height:10px;"/> </tr> <tr id="mail_separator_2"> <td> <hr style="height:3px; border:0px; background-color:#9D9D9D; color:#9D9D9D;"/> </td> </tr> <tr id="mail_footer"> <td align="center"> <table cellspacing="0" cellpadding="0" align="center" style="width:580px;"> <tr> <td style="height:30px; text-align:right; vertical-align:top; font-family:'Verdana Regular','Verdana','sans-serif'; font-size:11px; color:#9d9d9d;"> © Worldline </td> </tr> </table> </td> </tr> </table> </td> </tr> </table> </body> <!-- ATOS -net.atos.mm.fwk.wpm.media.DefaultTags.displayProperties --> </html>
Modèle SMS
Le contenu du SMS est personnalisable à l'aide d'un fichier de modèle texte.
En pratique, une variable déclarée avec la syntaxe "__FIELD_NAME__" est remplacée par la valeur de votre choix (Voir le chapitre Dictionnaire de balises ci-dessous pour connaître les balises existantes).
Exemples de modèles pour les SMS
La balise permet de remplacer toutes les variables avec la syntaxe "__FIELD_NAME__" par les valeurs de votre choix.
Exemple SMS Accepté
<!-- ATOS +net.atos.mm.fwk.wpm.media.DefaultTags.displayProperties --> REÇU DE PAIEMENT __MERCHANT_NAME__ Transaction n° __TRANSACTION_ID__ effectuée le __PAYMENT_DATE__ à __PAYMENT_TIME__ d'un montant de __AMOUNT__ ACCEPTÉE __CARD_TYPE__ __CARD_NUMBER__ Authorisation : __AUTHORISATION_ID__ Commande : __ORDER_ID__ <!-- ATOS -net.atos.mm.fwk.wpm.media.DefaultTags.displayProperties -->
Exemple SMS refusé
<!-- ATOS +net.atos.mm.fwk.wpm.media.DefaultTags.displayProperties --> PAIEMENT REFUSÉ __MERCHANT_NAME__ Transaction n° __TRANSACTION_ID__ effectuée le __PAYMENT_DATE__ à __PAYMENT_TIME__ d'un montant de __AMOUNT__ REFUSÉE __CARD_TYPE__ __CARD_NUMBER__ Commande : __ORDER_ID__ <!-- ATOS -net.atos.mm.fwk.wpm.media.DefaultTags.displayProperties -->
Dictionnaire des balises
Valeurs disponibles
Balise |
Format |
Description |
---|---|---|
ACCEPTOR_ID |
Alphanumérique |
Numéro d'approbation |
AMOUNT |
Numérique |
Montant du paiement dans la plus petite unité de la devise (exemple : 100 correspond à 1 €) |
AUTHORISATION_ID |
Alphanumérique |
Identifiant d'autorisation |
CADDIE |
Alphanumérique |
Liste d'éléments achetés |
CARD_NUMBER |
Alphanumérique |
Volet masqué (exemple : 4955 #### #### 1234) |
CARD_TYPE |
Alphanumérique |
Nom du mode de paiement utilisé par l'acheteur |
CARD_VALIDITY |
Date (mm/aaaa) |
Date de validité de la carte |
MERCHANT_CITY |
Alphanumérique |
Ville du marchand |
MERCHANT_COUNTRY |
Alphanumérique |
Pays du marchand |
MERCHANT_EMAIL |
Alphanumérique |
Adresse e-mail du marchand |
MERCHANT_ID |
Numérique |
Identifiant du marchand |
MERCHANT_NAME |
Alphanumérique |
Nom du marchand |
MERCHANT_WEB_ADDRESS |
Alphanumérique |
URL de la boutique du marchand |
MERCHANT_ZIPCODE |
Alphanumérique |
Code postal du marchand |
OPC |
Alphanumérique |
Mode de règlement des transactions |
ORDER_ID |
Alphanumérique |
Numéro de commande |
PAYMENT_CERTIFICATE |
Alphanumérique |
Certificat de paiement |
PAYMENT_DATE |
Date (jj/mm/aa) |
Date de l'opération |
PAYMENT_TIME |
Date (hh:mm) |
Heure de l'opération |
TRANSACTION_ID |
Alphanumérique |
Identifiant de transaction |