Ajouter le moyen de paiement e-chèque-vacances (ANCV) Systempay 2.3



Documents pareils
Guide d implémentation. Réussir l intégration de Systempay

Plateforme Systempay. Correspondance entre SP PLUS et SYSTEMPAY Paiement Simple et en plusieurs fois

Plateforme PAYZEN. Intégration du module de paiement pour la plateforme Magento version 1.3.x.x. Paiement en plusieurs fois. Version 1.

Plateforme Systempay Descriptif de l interface avec la page de paiement

Guide d implémentation

Plateforme PAYZEN. Définition de Web-services

Plateforme PAYZEN. Intégration du module de paiement pour la plateforme Magento 1.4 et supérieur. Version 1.5.1

Guide d implémentation. Gestion des paiements par identifiant Gestion des paiements par abonnement

Définition des Webservices Ordre de paiement par . Version 1.0

Définition des Webservices V4

Paiement sécurisé sur Internet. Pack Factures Documentation générale sur le paiement de factures par carte bancaire sur apayer.fr

Guide d utilisation de PayPal e-terminal. Informations à usage professionnel uniquement

FOIRE AUX QUESTIONS PAIEMENT PAR INTERNET. Nom de fichier : Monetico_Paiement_Foire_aux_Questions_v1.7 Numéro de version : 1.7 Date :

Guide utilisateur du prélèvement bancaire SEPA

Guide d implémentation. Paiement par identifiant Fichier des cartes arrivant à expiration

Définition des Webservices Standards Systempay Version 2.7c

Secure Card Data. Spécifications. Version SIX Payment Services

Guide d implémentation Interface avec la plateforme de paiement

Paiement sécurisé sur Internet. Tableau de bord Commerçant

Paiement sécurisé sur Internet

Intégration du moteur d envoi de SMS pour : Prestashop

Paiement sécurisé sur Internet. Documentation Technique

CYCLE DE VIE DES TRANSACTIONS

Paiement sécurisé sur Internet. Fonctionnalités du Pack Factures

e)services - Guide de l utilisateur e)carpa

TFC. (Téléphone, Fax, Courrier)

Achetez en toute sécurité sur Internet sans communiquer votre numéro de carte bancaire!

ACCUEIL - P. 5 DEMANDES DE PAIEMENT - P. 8

Écriture de journal. (Virement de dépense)

Guide d'utilisation de l'environnement de test

Guide d utilisation Billetterie FFR. Avril 2014 V0

PRODIGE V3. Manuel utilisateurs. Consultation des métadonnées

Module pour la solution e-commerce Magento

14.1. Paiements et achats en ligne

Le Service de Télétransmission par Internet des banques du Réseau OCÉOR GUIDE UTILISATEURS. Version V1.0

Panorama sur les nouveaux modes de paiement

Manuel d utilisation de la plate-forme de gestion de parc UCOPIA. La mobilité à la hauteur des exigences professionnelles

CONDITIONS GENERALES DE VENTE : BOUTIQUE EN LIGNE

Services de banque en ligne de la BADR BADRnet/ GUIDE UTILISATEURS

Gestionnaire de Réservations Guide Utilisateur

Solutions web : instructions aux développeurs

Sommaire de l Epargne en ligne. GUIDE D UTILISATION DU SITE

Qlik Sense Cloud. Qlik Sense Copyright QlikTech International AB. Tous droits réservés.

Manuel Utilisateur de l'installation du connecteur Pronote à l'ent

MANUEL UTILISATEUR DU SITE D INSCRIPTIONS FCL1.028 DGAC POUR LES CANDIDATS AUX CONTROLES DE COMPETENCES LINGUISTIQUES LANGUE ANGLAISE ORGANISES PAR LA

Manuel d'installation

Fiche FOCUS. Les téléprocédures. Payer un avis de CFE-IFER/TP

GUIDE DE PAIEMENT. Pour Bien Effectuer votre Paiement, veuillez suivre les instructions suivantes :

Les solutions de paiement CyberMUT (Crédit Mutuel) et CIC. Qui contacter pour commencer la mise en place d une configuration de test?

FileSender par RENATER - Guide utilisateur

CONDITIONS GENERALES DU SERVICE BANQUE EN LIGNE ECOBANK

FAIRE UN PAIEMENT TIPI

Karine PEREIRA Animatrice manager Cyber-base de la Nièvre FOURCHAMBAULT / LA CHARITE SUR LOIRE

Direction des projets

CONDITIONS GENERALES DE VENTE DE LA BOUTIQUE EN LIGNE TANGO

DESCRIPTION DES JOURNAUX DE REPORTING

PayPal Intégral. Guide de démarrage. Acceptez les paiements en ligne grâce à une plateforme complète. Leader mondial des paiements en ligne

Taxe de séjour - Manuel de l utilisateur. Déclaration en ligne. Logiciel 3D Ouest

boursorama expert Le guide Découvrir la plateforme Boursorama Expert

Module Communication - Messagerie V6. Infostance. Messagerie

Manuel. Administration P.CONSEIL. 12 avril Statut :

Un exemple d'authentification sécurisée utilisant les outils du Web : CAS. P-F. Bonnefoi

Comment utiliser mon compte alumni?

Vérification intégrée de l'utilisateur Guide d'implémentation client Confidentiel Version 2.9

BNP Net Entreprises BNP Net Evolution

AIDE MEMOIRE. Forprev. De l habilitation à la gestion de sessions. Page 1 sur 55

Faites confiance à la première solution française de paiement sur Internet.

E-TRANSACTIONS. Guide du programmeur API Plug-in. Version 1.1

Plateforme de banque en ligne d'al Salam Bank Algeria. Al Salam Moubachir /Guide Utilisateurs/

Plateforme de vente aux enchères et de vente de gré à gré du ministre. Guide de l utilisateur

Guide d utilisation «Extranet Formation» V3.5

Documentation utilisateur "OK-MARCHE" Historique des modifications. 3.0 Mise à jour complète suite à version OK-MARCHE V2.2. de marchés publics

INTRODUCTION AUX TESTS DE PERFORMANCE ET DE CHARGE

Comment bien démarrer avec. NetAirClub GUIDE ADMINISTRATEUR V1.5. Table des matières

CONDITIONS PARTICULIERES D UTILISATION DU COMPTE EN LIGNE

Erreurs les plus fréquentes Guide de dépannage

Guide d usage du portail périscolaire de la Ville de Lorient

CONDITIONS PARTICULIERES D UTILISATION DE L ESPACE CLIENT SUR LE SITE

Copyright Point / Paybox - Document non contractuel SOLUTIONS DE PAIEMENT E-COMMERCE

Application de Gestion des Notes de Frais sous Lotus Notes via un navigateur avec WorkFlow 1

OPENFLYERS Mode dʼemploi Adhérent

Le Rapprochement Bancaire. Mode d'emploi

pour vos ventes à distance

Manuel d utilisation du module Liste de cadeaux PRO par Alize Web

MANUEL D UTILISATION DE LA SALLE DES MARCHES APPEL D OFFRES OUVERT ACCES ENTREPRISES. Version 8.2

Création d'un site dynamique en PHP avec Dreamweaver et MySQL

Processus de commande en ligne des produits répertoriés sur notre site Web

MANUEL D UTILISATION LIVRET DE L ENSEIGNANT

Cahier des charges Site Web Page 1 sur 9

Réaliser des achats en ligne

Guide d intégration Dernière révision : juillet 2004

Manuel de l utilisateur Solwatt du service extranet.

Création d un compte Exchange (Vista / Seven)

Compagnie des Transports Strasbourgeois. 1. La vente en ligne : comment ça marche? Avant de recharger ma carte BADGEO... 2

Manuel d utilisation du logiciel RÉSULTATS. Édition destinée aux départements

Information sur l accés sécurisé aux services Baer Online Monaco

Version: 1.1 Date du document: 07 Novembre 2013 N du document: Guide Utilisateur Mandant. Guide utilisateur Mandant Page 1 de 20

Transcription:

Ajouter le moyen de paiement e-chèque-vacances (ANCV) Systempay 2.3 Version du document 1

Sommaire 1. HISTORIQUE DU DOCUMENT... 3 2. LE PAIEMENT FRACTIONNÉ : UTILISER PLUSIEURS MOYENS DE PAIEMENT... 4 2.1. Les e-chèques-vacances...4 Le numéro de remise...4 3. PROPOSER LES E-CHÈQUES-VACANCES SUR LA PAGE DE PAIEMENT... 6 3.1. Prérequis... 6 3.2. Visualiser le déroulement d'un paiement e-chèque-vacances sur la page de paiement...7 3.3. Visualiser la transaction dans le Back Office...11 4. ENVOYER LA DEMANDE DE PAIEMENT... 14 4.1. Rediriger l'acheteur vers la page de paiement... 14 4.2. Gérer les erreurs... 14 5. ANALYSER LE RÉSULTAT DU PAIEMENT... 15 5.1. Traiter les données spécifiques à la réponse d'un paiement fractionné (plusieurs moyens de paiement)... 15 5.2. Obtenir le numéro de remise par Web Services...19

1. HISTORIQUE DU DOCUMENT Version Auteur Date Commentaire 1.0 Lyra Network 17/02/2015 Version initiale format DITA Confidentialité Toutes les informations contenues dans ce document sont considérées comme confidentielles. L utilisation de celles-ci en dehors du cadre de cette consultation ou la divulgation à des personnes extérieures est soumise à l approbation préalable de Lyra Network. Droit de propriété intellectuelle - 3 / 19

2. LE PAIEMENT FRACTIONNÉ : UTILISER PLUSIEURS MOYENS DE PAIEMENT Le paiement fractionné est un service permettant à l acheteur de régler la totalité d un achat en utilisant plusieurs moyens de paiement. Exemple : une partie de la commande est payée par e-chèque-vacances et le solde par carte bancaire. On parlera de séquences de paiement pour définir l'ensemble des transactions effectuées pour régler la totalité d'un achat. Séquences de paiement Toutes les transactions d un paiement fractionné sont regroupées au sein d une séquence de paiement. Toutes les transactions d une séquence de paiement possèdent le même identifiant de transaction, mais un numéro de séquence différent. La première transaction de la séquence possède le numéro 1, la deuxième le numéro 2 et ainsi de suite. 2.1. Les e-chèques-vacances Le e-chèque-vacances (ecv), d'une valeur faciale de 60, permet de payer exclusivement des prestations de services liées aux vacances et aux loisirs : hébergement, séjours et transports, restauration, culture et découverte, loisirs, détente. Il est utilisable pour des séjours en France (dont les Dom-Tom) et les voyages à destination des pays membres de l Union européenne. L unicité d un titre ecv est déterminée par la combinaison N de chèque / N organisme / Année d'émission. L ecv se voit doté d une zone à gratter dissimulant un code de sécurité (servant à l authentification du ecv par le serveur de titres de l'ancv, l'agence Nationale pour les Chèques-Vacances). Il est utilisable uniquement en ligne sur les sites marchands conventionnés ANCV et proposant le moyen de paiement par ecv (voir chapitre Prérequis pour proposer les e-chèques-vacances sur la page de paiement). Une fois utilisés lors d un achat en ligne, les ecv sont considérés comme «consommés» par le serveur de l ANCV, sans retour possible à l état consommable. Pour plus d'informations : http://www.ancv.com/questions-les-plus-frequentes Le numéro de remise Le numéro de remise identifie de manière unique le remboursement de l ANCV pour le site marchand. Ce numéro correspond au lot d'e-chèques-vacances. Le processus de remboursement des e-chèques-vacances de l ANCV au marchand est automatisé. Il est effectué par virement bancaire dans un délai maximum de 21 jours après validation des e-chèques- Vacances au remboursement. Droit de propriété intellectuelle - 4 / 19

A la validation d une transaction, un numéro de remise est transmis au site marchand qui peut alors, en se connectant à l'extranet de l'ancv, rapprocher le montant e-chèques-vacances encaissé et le montant viré par l ANCV (moyennant la déduction de la commission). Image 1 : Numéro de remise Le numéro de remise est affiché dans le Back Office depuis le menu Gestion > Transactions. Les transactions e-chèques-vacances pour un paiement accepté sont visibles dans l'onglet Transactions remisées. Le numéro de remise est affiché dans la colonne N de remise. Droit de propriété intellectuelle - 5 / 19

3. PROPOSER LES E-CHÈQUES-VACANCES SUR LA PAGE DE PAIEMENT Informations importantes relatives à l'ajout de ce moyen de paiement : Type d'intégration Uniquement disponible via une intégration par formulaire de paiement en redirection. Restriction Pas d'intégration possible via les Web Services. Nom du champ pour personnaliser la liste des moyens de paiement vads_payment_cards Valeur de vads_payment_cards pour les e-chèques-vacances E_CV Exemple Pour proposer par exemple Visa, MasterCard et e-chèque-vacances sur la page de paiement, la ligne de code dans le formulaire de paiement est la suivante : <input type="hidden" name="vads_payment_cards" value="visa;mastercard;e_cv" /> Remarque : Si la liste ne contient qu'un type de carte, la page de saisie des données de ce moyen de paiement sera directement présentée. Sinon la page de sélection des moyens de paiement sera présentée. Si ce paramètre est vide (conseillé) alors tous les moyens de paiement éligibles (devises, contraintes techniques, etc.) associés à la boutique seront proposés. 3.1. Prérequis L'ajout de ce moyen de paiement sur la page de paiement du site marchand est très simple. Le marchand doit : Être un Professionnel du Tourisme et des Loisirs (PTL). Être prestataire de l'ancv, c'est-à-dire être conventionné par l'ancv. En devenant prestataire de l'ancv, le marchand reçoit un numéro de convention. Ce numéro sera utilisé en tant que numéro de contrat dans son Back Office. Le marchand devra compléter une "attestation ANCV". Cette attestation fait partie des documents de souscription que doit compléter le marchand (avec le formulaire d'inscription et les CGS). Demander l'activation du moyen de paiement e-chèque-vacances auprès de la plateforme de paiement. Droit de propriété intellectuelle - 6 / 19

3.2. Visualiser le déroulement d'un paiement e-chèque-vacances sur la page de paiement Le diagramme ci-dessous présente la cinématique des échanges du point de vue de l'acheteur. 1. L'acheteur valide son panier. Image 2 : Cinématique des échanges 2. Le site marchand redirige l acheteur vers la plateforme de paiement. Pour plus d'informations, veuillez vous référer au guide d'implémentation du formulaire disponible sur notre site documentaire. 3. La plateforme de paiement, après vérification des paramètres et de leur signature, présente sa page de choix du moyen de paiement. 4. L'acheteur sélectionne son premier moyen de paiement, par exemple le e-chèque-vacances. Image 3 : Sélection du moyen de paiement 5. L'acheteur confirme qu'il est en possession de e-chèque-vacances. Dans le cas contraire (Chèque-Vacances classique), il est invité à sélectionner un autre moyen de paiement. Droit de propriété intellectuelle - 7 / 19

Image 4 : Confirmation du moyen de paiement 6. L'acheteur saisit les informations relatives à son e-chèque-vacances. Il renseigne : le numéro du chèque, le numéro de l'organisme, l'année d'émission de son e-chèque-vacances, le code de sécurité (zone à gratter). 7. L'acheteur clique sur Ajouter. Image 5 : Saisie des informations relatives au e-chèque-vacances La plateforme de paiement interroge par Web Service le serveur de titres de l'ancv. Le serveur de l'ancv vérifie le e-chèque-vacances saisi (validité du chèque, consommable, code de sécurité correct...). Si le e-chèque-vacances est valide, le serveur de l'ancv enregistre sa réservation et retourne à la plateforme : la valeur faciale du e-chèque-vacances, le nom du porteur du e-chèque-vacances, la liste des titres consommables du même carnet et leurs informations associées (n du e-chèque- Vacances, n de l'organisme, année d'émission et valeur faciale). 8. La plateforme de paiement actualise la page de paiement et affiche (ou non, selon le montant) la liste des e-chèques-vacances consommables du même carnet. Le nombre de e-chèque-vacances affichés dépend du montant restant dû. Droit de propriété intellectuelle - 8 / 19

9. L'acheteur peut soit : ajouter un e-chèque-vacances de la liste en indiquant son code de sécurité, saisir un autre e-chèque-vacances, supprimer un e-chèque-vacances déjà ajouté. 10.Une fois la saisie des e-chèques-vacances terminée, l'acheteur clique sur VALIDER. Image 6 : Résumé des e-chèques-vacances utilisés La plateforme de paiement propose un récapitulatif des paiements partiels effectués. Il est possible de supprimer l'ensemble des e-chèques-vacances saisis ou retourner sur la page d'édition des e-chèques-vacances. Image 7 : Récapitulatif des paiements partiels effectués 11.L acheteur sélectionne son moyen de paiement pour régler le solde de la commande. 12.Il renseigne le numéro et la date d'expiration de sa carte. Si la carte possède un cryptogramme visuel, ce dernier doit obligatoirement être renseigné. Droit de propriété intellectuelle - 9 / 19

13.Il confirme sa saisie en cliquant sur VALIDER. Image 8 : Saisie des données bancaires 14.Si le marchand et la carte de l acheteur sont enrôlés dans le programme 3D Secure, une authentification 3D Secure a lieu. 15.Une demande d'autorisation est effectuée auprès de la banque de l acheteur, l émetteur, en plus des contrôles de fraudes internes de la plateforme de paiement. Si le paiement est refusé, la plateforme de paiement annule la réservation des e-chèques-vacances auprès du serveur de titres de l'ancv. Si le paiement est accepté, la plateforme de paiement valide définitivement la réservation des e- Chèques-Vacances auprès du serveur de titres de l'ancv 16.En cas de succès, une page de résumé est présentée à l acheteur récapitulant les informations des séquences de paiement. Un bouton permettant un retour à la boutique est proposé. Image 9 : Résumé des séquences de paiement En cas d échec, un message s affiche. L acheteur est informé du refus de la demande de paiement. Un bouton permettant d annuler et de retourner à la boutique est proposé. Droit de propriété intellectuelle - 10 / 19

Remarque : tout au long du processus de paiement, la plateforme de paiement peut être amenée à annuler la réservation des e-chèques-vacances dans les cas suivants : retour boutique de la part de l'acheteur avant la fin de la validation du paiement, expiration de la session de paiement, dysfonctionnement technique (serveur de l'ancv injoignable...) 3.3. Visualiser la transaction dans le Back Office Les transactions sont visibles dans le Back Office depuis le menu Gestion > Transactions. Les transactions e-chèques-vacances pour un paiement accepté sont visibles dans l'onglet Transactions remisées. En effet, les e-chèques-vacances sont validés en temps réel auprès du serveur de titres de l'ancv, le délai de remise est donc égal à 0. Remarque : l'ensemble des transactions e-chèque-vacances d'un paiement fractionné possède un numéro de remise unique. Ce dernier est transmis par l'ancv au moment de la validation de la réservation des e-chèques-vacances lors du paiement. Ce numéro correspond au lot d'e-chèques- Vacances. Il est affiché dans la colonne N remise. La transaction par carte bancaire est visible dans l'onglet Transactions en cours jusqu'à sa remise. Remarque : Les transactions e-chèque-vacances visibles dans l'onglet Transactions en cours correspondent à des annulations (e-chèques-vacances supprimés après ajout sur la page de paiement) ou des refus (blocage d'un e-chèque-vacances après 3 erreurs sur le code de sécurité sur la page de paiement). Pour visualiser le détail d'une transaction ANCV : 1. Sélectionnez une transaction ANCV. 2. Effectuez un clic droit puis sélectionnez Afficher le détail de la transaction. La boîte de dialogue Détail d'une transaction en cours apparaît. Droit de propriété intellectuelle - 11 / 19

Image 10 : Détail d'une transaction Parmi les informations présentées, vous trouverez : Le moyen de paiement utilisé (ANCV) L'identifiant de la transaction Le numéro de séquence Le montant de la transaction La date de création de la transaction Le statut de la transaction Le numéro du moyen de paiement Sa valeur est issue de la concaténation du numéro de chèque - numéro organisme - année d'émission Droit de propriété intellectuelle - 12 / 19

Pour visualiser le détail du paiement fractionné (liste des séquences) : 1. Sélectionnez une transaction ANCV. 2. Effectuez un clic droit puis sélectionnez Afficher le détail de la transaction. La boîte de dialogue Détail d'une transaction en cours apparaît. 3. Cliquez sur l'onglet Multi-moyens de paiement. Image 11 : Détail du paiement fractionné Les séquences qui composent le paiement fractionné sont affichées (e-chèques-vacances et carte bancaire). Remarque : tous les e-chèques-vacances authentifiés par le serveur de titres de l'ancv sont affichés y compris les e-chèques-vacances ayant fait l'objet d'une suppression sur la page de paiement. Droit de propriété intellectuelle - 13 / 19

4. ENVOYER LA DEMANDE DE PAIEMENT Pour chaque transaction, l acheteur doit être redirigé vers la page de paiement afin de finaliser son achat. Son navigateur doit transmettre les données du formulaire de paiement. 4.1. Rediriger l'acheteur vers la page de paiement L URL de la plateforme de paiement est la suivante : https://paiement.systempay/vads-payment/ Exemple de paramètres envoyés à la plateforme de paiement: <form method="post" action="https://paiement.systempay/vads-payment/"> <input type="hidden" name="vads_action_mode" value="interactive" /> <input type="hidden" name="vads_amount" value="17800" /> <input type="hidden" name="vads_capture_delay" value="0" /> <input type="hidden" name="vads_ctx_mode" value="test" /> <input type="hidden" name="vads_currency" value="978" /> <input type="hidden" name="vads_cust_country" value="fr" /> <input type="hidden" name="vads_cust_email" value="nom.prenom@exemple.com" /> <input type="hidden" name="vads_page_action" value="payment" /> <input type="hidden" name="vads_payment_config" value="single" /> <input type="hidden" name="vads_site_id" value="12345678" /> <input type="hidden" name="vads_trans_date" value="20140526101407" /> <input type="hidden" name="vads_trans_id" value="913509" /> <input type="hidden" name="vads_validation_mode" value="0" /> <input type="hidden" name="vads_version" value="v2" /> <input type="hidden" name="signature" value="86b2a17b9a5fcefb6c0120c57b25ec86ad1704ee"/> <input type="submit" name="payer" value="payer"/> </form> 4.2. Gérer les erreurs Si la plateforme détecte une anomalie lors de la réception du formulaire, un message d erreur sera affiché et l acheteur ne pourra pas procéder au paiement. En mode TEST Le message indique l origine de l erreur et propose un lien vers la FAQ pour vous aider à la corriger. En mode PRODUCTION Le message indique simplement à l acheteur qu un problème technique est survenu. Dans les deux cas, le marchand reçoit un e-mail d'avertissement. Il contient: l origine de l erreur un lien vers la FAQ pour faciliter le diagnostic l ensemble des champs contenus dans le formulaire. La FAQ est disponible à cette adresse : https://paiement.systempay.fr/html/error_code/ Droit de propriété intellectuelle - 14 / 19

5. ANALYSER LE RÉSULTAT DU PAIEMENT L'analyse du résultat du paiement est décrit dans le Guide d'implémentation du formulaire de paiement disponible sur notre site documentaire (https://paiement.systempay.fr/html/). Dans ce document, seul le traitement des données spécifiques à la réponse d'un paiement fractionné est abordé. 5.1. Traiter les données spécifiques à la réponse d'un paiement fractionné (plusieurs moyens de paiement) Spécificités d'un paiement fractionné : Toutes les transactions d un paiement fractionné sont regroupées au sein d une séquence de paiement. Toutes les transactions d une séquence de paiement possèdent le même identifiant de transaction, mais un numéro de séquence différent. La première transaction de la séquence possède le numéro 1, la deuxième le numéro 2 et ainsi de suite. Contexte : Lors du paiement, l acheteur règle une partie de son achat avec des e-chèques-vacances, puis le solde au moyen d'une carte bancaire. Le paiement sera composé de N séquences détaillées par le champs vads_payment_seq. Remarque : il y a autant de transactions E_CV que de chèques saisis, plus une pour la carte bancaire. L'URL de notification instantanée contiendra notamment les informations ci-dessous : Nom du champ Description Valeur vads_trans_status Statut du paiement Les valeurs possibles sont : AUTHORISED Accepté, en attente de remise WAITING_AUTHORISATION En attente d'autorisation Droit de propriété intellectuelle - 15 / 19 WAITING_AUTHORISATION_TO_VALIDATE A valider et autoriser AUTHORISED_TO_VALIDATE A valider ABANDONED Paiement abandonné par l'acheteur REFUSED Refusé EXPIRED Expiré CANCELED Annulé CAPTURED Remisé Pour plus de détails, se référer au guide d'implémentation du formulaire disponible sur notre site documentaire (https:// paiement.systempay.fr/html/).

Nom du champ Description Valeur vads_auth_mode Mode d autorisation Les valeurs possibles sont : FULL Autorisation du montant total de la transaction. Valeur utilisée dans le cas d un paiement comptant, si la durée séparant la date de remise demandée de la date du jour est strictement inférieure à la durée de validité de l'autorisation. MARK vads_payment_config Type du paiement SINGLE vads_amount Montant dans la plus petite unité de la devise vads_currency Devise utilisée pour le paiement 978 vads_card_brand Type de carte utilisée pour le paiement Autorisation de 1 euro (demande de renseignement). Valeur utilisée dans le cas d'un paiement différé, si la durée séparant la date de remise demandée de la date du jour est strictement supérieure à la durée de validité de l'autorisation. 17800 pour 178.00 MULTI vads_payment_seq Détails des transactions réalisées Voir détails ci dessous Tableau 1 : Liste des champs à analyser - Paiement fractionné (plusieurs moyens de paiement) Le champ vads_payment_seq (format json) décrit la séquence de paiement fractionné. Il contient les éléments : "trans_id" : identifiant de la transaction global à la séquence de paiement. "transaction" : tableau des transactions de la séquence. Remarque : les transactions annulées sont également présentes dans le tableau. Chaque transaction de la séquence contient les éléments suivants : Nom du paramètre amount operation_type auth_number capture_delay Description Montant de la séquence de paiement. Opération de débit. Numéro d'autorisation retourné par le serveur bancaire, si disponible (sinon vide). Ce paramètre est retourné vide pour un paiement par e-chèque-vacances. En effet, le serveur de titres de l'ancv ne le fourni pas. Délai avant remise (en jours). Pour un paiement par e-chèques-vacances, ce paramètre est valorisé à 0. En effet, les e- Chèques-Vacances sont validés en temps réel. Pour un paiement par carte bancaire, la valeur de ce paramètre tient compte du délai en nombre de jours avant la remise en banque. Si ce paramètre n'est pas transmis dans le formulaire de paiement, la valeur par défaut définie dans le Back Office sera utilisée. card_brand Moyen de paiement utilisé. Pour un paiement par e-chèques-vacances, ce paramètre est valorisé à E_CV. Pour un paiement par carte bancaire (exemple CB ou cartes CB cobrandées Visa ou Mastercard), ce paramètre est valorisé à CB. card_number Se référer au guide d'intégration du formulaire de paiement disponible sur notre site documentaire pour visualiser la liste complète des types de carte. Numéro du moyen de paiement. Pour un paiement par e-chèques-vacances, ce paramètre est valorisé en concaténant le numéro de chèque - numéro organisme - année d'émission en les séparant avec le caractère "-". Pour un paiement par carte bancaire, le numéro est masqué. Droit de propriété intellectuelle - 16 / 19

Nom du paramètre expiry_month expiry_year payment_certificate presentation_date Description Mois d'expiration de la carte bancaire. Paramètre absent pour le paiement par e-chèque-vacances. Année d'expiration de la carte bancaire. Paramètre absent pour le paiement par e-chèque-vacances. Certificat de paiement. Pour un paiement par carte bancaire, ce paramètre correspond à la date de remise en banque souhaitée (au format ISO 8601). Pour un paiement par e-chèques-vacances, ce paramètre correspond à la date du jour de la commande. En effet, les e-chèques-vacances sont validés en temps réel auprès du serveur de titres de l'ancv. trans_id ext_trans_id sequence_number trans_status Numéro de transaction. Paramètre absent pour le paiement par carte bancaire. Pour un paiement par e-chèques-vacances, ce paramètre est un identifiant technique généré par la plateforme de paiement (référence de transaction). Numéro de séquence. Statut de la transaction. Tableau 2 : Contenu de l'objet JSON Exemple de valeur pour le champ vads_payment_seq Cas 1 : tous les e-chèques-vacances saisis sont ajoutés et validés { "trans_id":"913509", "transactions": [ { "amount":"6000", "operation_type":"debit", "auth_number":"", "capture_delay":"0", "card_brand":"e_cv", "card_number":"2002-838861-2015", "payment_certificate":"d396a0a9601dc88d23bba2224a41fe8c32676e2f", "presentation_date":"2015-02-18t16:12:01z", "trans_id":"913509", "ext_trans_id":"87c092a8403747cb9b1486cfa34c3dcc", "sequence_number":"1", "trans_status":"captured" }, { "amount":"6000", "operation_type":"debit", "auth_number":"", "capture_delay":"0", "card_brand":"e_cv", "card_number":"2004-838861-2015", "payment_certificate":"d396a0a9601dc88d23bba2224a41fe8c32676e2f", "presentation_date":"2015-02-18t16:12:01z", "trans_id":"913509", "ext_trans_id":"87c092a8403747cb9b1486cfa34c3dcc", "sequence_number":"2", "trans_status":"captured" }, { "amount":"5800", "operation_type":"debit", "auth_number":"3fec1e", "capture_delay":"0", "card_brand":"cb", "card_number":"497010xxxxxx0000", "expiry_month":"6", "expiry_year":"2016", "payment_certificate":"010a2db1ef864d6584424c41512dd9ad678c785e", "presentation_date":"2015-02-18t16:12:13z", "trans_id":"913509", "sequence_number":"3", "trans_status":"authorised" } ] } Droit de propriété intellectuelle - 17 / 19

Cas 2 : l'acheteur annule un e-chèque-vacance saisi A la différence du cas n 1, le champ "trans_status" est valorisé à CANCELLED pour refléter l'annulation du e-chèque-vacance par l'acheteur. "trans_id":"913509", "transactions": [ { "amount":"6000", "operation_type":"debit", "auth_number":"", "capture_delay":"0", "card_brand":"e_cv", "card_number":"2002-838861-2015", "payment_certificate":"d396a0a9601dc88d23bba2224a41fe8c32676e2f", "presentation_date":"2015-02-18t16:12:01z", "trans_id":"913509", "ext_trans_id":"87c092a8403747cb9b1486cfa34c3dcc", "sequence_number":"1", "trans_status":"cancelled" }, { "amount":"6000", "operation_type":"debit", "auth_number":"", "capture_delay":"0", "card_brand":"e_cv", "card_number":"2004-838861-2015", "payment_certificate":"d396a0a9601dc88d23bba2224a41fe8c32676e2f", "presentation_date":"2015-02-18t16:12:01z", "trans_id":"913509", "ext_trans_id":"87c092a8403747cb9b1486cfa34c3dcc", "sequence_number":"2", "trans_status":"captured" }, { "amount":"11800", "operation_type":"debit", "auth_number":"3fec1e", "capture_delay":"0", "card_brand":"cb", "card_number":"497010xxxxxx0000", "expiry_month":"6", "expiry_year":"2016", "payment_certificate":"010a2db1ef864d6584424c41512dd9ad678c785e", "presentation_date":"2015-02-18t16:12:13z", "trans_id":"913509", "sequence_number":"3", "trans_status":"authorised" } ] } Précisions : Si le paiement par carte bancaire est refusé, le champ "trans_status" est valorisé à REFUSED. La plateforme de paiement annule la réservation des e-chèques-vacances auprès du serveur de titres de l'ancv et le paiement est annulé dans sa globalité. Si le paiement par carte bancaire est accepté, le champ "trans_status" est valorisé à AUTHORISED. La plateforme de paiement valide définitivement la réservation des e-chèques-vacances auprès du serveur de titres de l'ancv. Le paiement par e-chèques-vacances et carte bancaire est validé. Droit de propriété intellectuelle - 18 / 19

5.2. Obtenir le numéro de remise par Web Services Le numéro de remise est affiché dans le Back Office depuis le menu Gestion > Transactions. Les transactions e-chèques-vacances pour un paiement accepté sont visibles dans l'onglet Transactions remisées. Le numéro de remise est affiché dans la colonne N de remise. Cependant, il est possible de le récupérer via les Web Services. Si vous utilisez les Web Services V4 Utilisez la fonction getinfo afin d'interroger la transaction et en connaître ses différents attributs. Cette fonction prend en entrée les paramètres suivants : Nom du champ Format Description Obligatoire siteid String / n8 Identifiant de la boutique. transmissiondate datetime / ans..40 Date et heure de création de la transaction à rechercher, exprimée au format W3C (Ex : 2015-02-18T16:12:01Z). transactionid String / an6 Identifiant de la transaction à rechercher sequencenumber Int / n..3 Numéro de séquence de la transaction à rechercher. Vaut "1" pour un paiement unitaire. Prend la valeur du numéro de séquence dans le cas d un paiement fractionné. ctxmode String Contexte de sollicitation de la plateforme de paiement ("TEST", "PRODUCTION"). wssignature String Signature Le calcul de la signature se fait en prenant les paramètres dans l ordre suivant : siteid, transactionid, sequencenumber, ctxmode Cette fonction retourne une réponse du type transactioninfo dans lequel le champ capturenumber renvoie le numéro de remise. Pour plus de détails, référez-vous à la documentation Web Services disponible sur notre site documentaire (https://paiement.systempay.fr/html/). Droit de propriété intellectuelle - 19 / 19