Ajouter le moyen de paiement e-Chèque-Vacances (ANCV)...Image 2 : Cinématique des échanges 1. L'acheteur valide son panier. 2. Le site marchand redirige l’acheteur vers la plateforme

Ajouter le moyen de paiemente-Chèque-Vacances (ANCV)

PayZen 2.5

Version du document 1.2

Sommaire

1. HISTORIQUE DU DOCUMENT........................................................................................................ 3

2. LE PAIEMENT FRACTIONNÉ : UTILISER PLUSIEURS MOYENS DE PAIEMENT............... 42.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............................. 63.1. Prérequis...................................................................................................................................................... 73.2. Visualiser le déroulement d'un paiement e-Chèque-Vacances sur la page de paiement.............................83.3. Visualiser la transaction dans le Back Office...........................................................................................13

4. ENVOYER LA DEMANDE DE PAIEMENT.................................................................................. 164.1. Rediriger l'acheteur vers la page de paiement.......................................................................................... 164.2. Gérer les erreurs........................................................................................................................................ 16

5. ANALYSER LE RÉSULTAT DU PAIEMENT............................................................................... 175.1. Traiter les données spécifiques à la réponse d'un paiement fractionné (plusieurs moyens de

paiement)..................................................................................................................................................... 175.2. Obtenir le numéro de remise par Web Services....................................................................................... 22

Ajouter le moyen de paiement e-Chèque-Vacances (ANCV) - Version du document 1.2

Droit de propriété intellectuelle - 3 / 22

1. HISTORIQUE DU DOCUMENT

Version Auteur Date Commentaire

1.2 Lyra Network 08/02/2016 Information complémentaire pour définir le contrat commerçantà utiliser

1.1 Lyra Network 09/11/2015 Chapitre Traiter les données spécifiques à la réponse d'unpaiement fractionné (plusieurs moyens de paiement),informations complémentaires sur les champs :

• vads_trans_status

• vads_auth_mode

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.



2. LE PAIEMENT FRACTIONNÉ : UTILISER PLUSIEURS MOYENS DEPAIEMENT

Le paiement fractionné est un service permettant à l’acheteur de régler la totalité d’un achat en utilisantplusieurs 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 latotalité 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, maisun numéro de séquence différent. La première transaction de la séquence possède le numéro 1, ladeuxiè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 prestationsde 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 paysmembres 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 dueCV par le serveur de titres de l'ANCV, l'Agence Nationale pour les Chèques-Vacances). Il est utilisableuniquement en ligne sur les sites marchands conventionnés ANCV et proposant le moyen de paiement pareCV (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 del’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. Cenumé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 esteffectué par virement bancaire dans un délai maximum de 21 jours après validation des e-Chèques-Vacances au remboursement.

http://www.ancv.com/Questions-les-plus-frequentes



A la validation d’une transaction, un numéro de remise est transmis au site marchand qui peut alors, ense connectant à l'extranet de l'ANCV, rapprocher le montant e-Chèques-Vacances encaissé et le montantviré 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 Transactionsremisées. Le numéro de remise est affiché dans la colonne N° de remise.



3. PROPOSER LES E-CHÈQUES-VACANCES SUR LA PAGE DEPAIEMENT

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 decode 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 seradirectement 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, contraintestechniques, etc.) associés à la boutique seront proposés.

• Nom du champ pour définir le contrat commerçant

vads_contracts

Le marchand peut spécifier dans son formulaire de paiement la valeur du contrat commerçant à utiliser.

Cette fonctionnalité n'est utile que si vous possédez plusieurs contrats sur un même réseaud’acceptation.

• Valeur de vads_contracts pour un contrat ANCV

ANCV

Le contrat ANCV doit être valorisé de la façon suivante : n° de convention-n° d'encaisseur-n° de pointd'accueil

Les trois informations doivent être séparées par un tiret "-".

La ligne de code dans le formulaire de paiement est la suivante :

<input type="hidden" name="vads_contracts=ANCV=123456-7-8" />



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 desouscription 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 depaiement.



3.2. Visualiser le déroulement d'un paiement e-Chèque-Vacances sur lapage de paiement

Le diagramme ci-dessous présente la cinématique des échanges du point de vue de l'acheteur.

Image 2 : Cinématique des échanges

1. L'acheteur valide son panier.

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 surnotre site documentaire.

3. La plateforme de paiement, après vérification des paramètres et de leur signature, présente sa pagede 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 depaiement.

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).



Image 5 : Saisie des informations relatives au e-Chèque-Vacances

7. L'acheteur clique sur Ajouter.

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 desécurité correct...).

Si le e-Chèque-Vacances est valide, le serveur de l'ANCV enregistre sa réservation et retourne à laplateforme :

• 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 listedes e-Chèques-Vacances consommables du même carnet. Le nombre de e-Chèque-Vacances affichésdépend du montant restant dû.

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'éditiondes 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é.



Image 8 : Saisie des données bancaires

13.Il confirme sa saisie en cliquant sur VALIDER.

14.Si le marchand et la carte de l’acheteur sont enrôlés dans le programme 3D Secure, une authentification3D Secure a lieu.

15.Une demande d'autorisation est effectuée auprès de la banque de l’acheteur, l’émetteur, en plus descontrô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-Vacancesauprè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 dessé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. Unbouton permettant d’annuler et de retourner à la boutique est proposé.

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 Transactionsremisées.

En effet, les e-Chèques-Vacances sont validés en temps réel auprès du serveur de titres de l'ANCV, ledélai de remise est donc égal à 0.

Remarque : l'ensemble des transactions e-Chèque-Vacances d'un paiement fractionné possède unnuméro de remise unique. Ce dernier est transmis par l'ANCV au moment de la validation de laré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 courscorrespondent à 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 depaiement).



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.

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



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 cartebancaire).

Remarque : tous les e-Chèques-Vacances authentifiés par le serveur de titres de l'ANCV sont affichés ycompris les e-Chèques-Vacances ayant fait l'objet d'une suppression sur la page de paiement.



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://secure.payzen.eu/vads-payment/

Exemple de paramètres envoyés à la plateforme de paiement:

<form method="POST" action="https://secure.payzen.eu/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="[email protected]" /><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://secure.payzen.eu/html/error_code/



https://secure.payzen.eu/html/error_code/



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 paiementdisponible sur notre site documentaire (https://payzen.io/-fr-FR/).

Dans ce document, seul le traitement des données spécifiques à la réponse d'un paiement fractionné estabordé.

5.1. Traiter les données spécifiques à la réponse d'un paiementfractionné (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 aumoyen 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 Le statut retourné est fonction des modalités du paiement.

• Si le paiement est exclusivement réalisé avec des e-Chèques-Vacances :La valeur est CAPTURED c'est-à-dire remisé.En effet, les e-Chèques-Vacances sont validés en temps réelauprès du serveur de titres de l'ANCV.

• Si le paiement est complété par un autre moyen depaiement, la valeur du statut est celle du complément.

• Carte bancaire sans délai de remise en banqueLes valeurs possibles sont :AUTHORISED

Accepté, en attente de remise

CAPTURED

Remisé

• Carte bancaire avec délai de remise en banquesupérieur à 0 jour ou necessitant une action de la partdu marchand :Les valeurs possibles sont :WAITING_AUTHORISATION

En attente d'autorisation

WAITING_AUTHORISATION_TO_VALIDATE

A valider et autoriser

AUTHORISED_TO_VALIDATE

A valider

https://payzen.io/-fr-FR/



Nom du champ Description Valeur

• Si le paiement n'a pas lieu, les valeurs possibles sont :

• ABANDONED

Paiement abandonné par l'acheteur

• REFUSED

Refusé

• EXPIRED

Expiré

• CANCELED

Annulé

vads_auth_mode Mode d’autorisation Les valeurs possibles sont :

• FULL

Si le paiement est exclusivement réalisé avec des e-Chèques-Vacances ou si le complément est réalisé avec unmoyen de paiement sans autorisation de 1 euro.

• MARK

Si le complément à donné lieu à une autorisation de 1euro (valeur utilisée dans le cas d'un paiement différé, sila durée séparant la date de remise demandée de la datedu jour est strictement supérieure à la durée de validité del'autorisation. Pour plus d'information, veuillez vous référerau guide d'implémentation du formulaire disponible surnotre site documentaire).

vads_payment_config Type du paiement SINGLE

vads_amount Montant dans la plus petite unitéde la devise

17800 pour 178.00€

vads_currency Devise utilisée pour le paiement 978

vads_card_brand Type de carte utilisée pour lepaiement

MULTI

vads_payment_seq Détails des transactions réalisées Voir détails ci-après

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 Description

amount Montant de la séquence de paiement.

operation_type Opération de débit.

auth_number 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 detitres de l'ANCV ne le fourni pas.

capture_delay 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 ennombre de jours avant la remise en banque. Si ce paramètre n'est pas transmis dans leformulaire 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 ouMastercard), ce paramètre est valorisé à CB.

Se référer au guide d'intégration du formulaire de paiement disponible sur notre sitedocumentaire pour visualiser la liste complète des types de carte.

card_number Numéro du moyen de paiement.

• Pour un paiement par e-Chèques-Vacances, ce paramètre est valorisé en concaténant lenumé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é.

expiry_month Mois d'expiration de la carte bancaire.Paramètre absent pour le paiement par e-Chèque-Vacances.

expiry_year Année d'expiration de la carte bancaire.Paramètre absent pour le paiement par e-Chèque-Vacances.

payment_certificate Certificat de paiement.

presentation_date • Pour un paiement par carte bancaire, ce paramètre correspond à la date de remise en banquesouhaitée (au format ISO 8601).

• Pour un paiement par e-Chèques-Vacances, ce paramètre correspond à la date du jour de lacommande. En effet, les e-Chèques-Vacances sont validés en temps réel auprès du serveur detitres de l'ANCV.

trans_id Numéro de transaction.

ext_trans_id 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é parla plateforme de paiement (référence de transaction).

sequence_number Numéro de séquence.

trans_status 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" } ]}

• 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 due-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 titresde 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 duserveur de titres de l'ANCV. Le paiement par e-Chèques-Vacances et carte bancaire est validé.



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 Transactionsremisé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 auformat 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 paiementfractionné.

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 captureNumberrenvoie le numéro de remise.

Pour plus de détails, référez-vous à la documentation Web Services disponible sur notre site documentaire(https://payzen.io/-fr-FR/).

• Si vous utilisez les Web Services V5

Utilisez l'opération getPaymentDetails afin d'interroger la transaction et en connaître ses différentsattributs.

Pour plus de détails, référez-vous à la documentation Web Services disponible sur notre site documentaire(https://payzen.io/-fr-FR/).



Documents

Ajouter le moyen de paiement e-Chèque-Vacances (ANCV)...Image 2 : Cinématique des échanges 1. L'acheteur valide son panier. 2. Le site marchand redirige l’acheteur vers la plateforme