Introduction
Worldline Sips est une solution de paiement de commerce électronique multicanale sécurisée conforme à la norme PCI DSS. Elle vous permet d’accepter et de gérer des transactions de paiement en prenant en compte les règles métier liées à votre activité (paiement à la livraison, paiement différé, paiement récurrent, paiement en plusieurs fois…).
L’objectif du présent document est d’expliquer l'intégration du moyen de paiement AirPlus Logee dans Worldline Sips.
À qui s’adresse ce document ?
Ce document a pour objectif de vous aider à implémenter le moyen de paiement AirPlus Logee sur votre site de commerce électronique.
Il comprend :
- des informations fonctionnelles à votre attention ;
- des instructions d'implémentation à destination de votre équipe technique.
Pour avoir une vue d’ensemble de la solution Worldline Sips, nous vous conseillons de consulter les documents suivants :
- Présentation fonctionnelle
- Guide de configuration des fonctionnalités
Comprendre les paiements AirPlus Logee avec Worldline Sips
Principes généraux
Une carte AirPlus Logee est une carte stockée dans un portefeuille électronique d’un voyagiste ou d’une agence de voyage pour le compte d’une entreprise. Elle permet à des membres de l’entreprise en question d’effectuer des transactions, pour réservation de voyage professionnel par exemple, directement avec le compte de l’entreprise.
Le client final, à savoir le membre de l’entreprise, n’a donc pas à saisir le numéro et la date de validité de la carte puisque ces informations sont stockées dans le Wallet du commerçant (voyagiste ou agence de voyage).
La carte AirPlus Logee est une carte de paiement internationale émise par et associée au réseau de paiement AirPlus. Une carte logée est une carte qui n'appartient pas à un particulier, mais à une entreprise. Elle n'est donc pas nominative et ne peut faire l'objet d'une authentification forte.
Pour effectuer un paiement avec une carte du réseau AirPlus Logee, le commerçant doit fournir les renseignements suivant :
- Le numéro de carte ;
- La date d’expiration.
Règles d’acceptation
Fonctionnalités disponibles
| Canaux de paiement | ||
|---|---|---|
| Internet | V | Canal de paiement par défaut |
| MAIL_ORDER, TELEPHONE_ORDER | V | |
| Télécopie | X | |
| SVI | X | |
| Typologies de paiement | ||
|---|---|---|
| Paiement immédiat | X | |
| Paiement en fin de journée | V | Méthode de paiement forcée |
| Paiement différé | X | |
| Paiement à l'expédition | X | |
| Paiement en plusieurs fois | X | |
| Paiement par abonnement | X | |
| Paiement par fichier | V | |
| Paiement OneClick | X | |
| Gestion des devises | ||
|---|---|---|
| Acceptation multidevise | V | Selon votre contrat |
| Règlement en devise | V | Selon votre contrat |
Demande d'autorisation
La durée d’autorisation pour les cartes AirPlus Logee est forcée à 0 jour (remise en banque à la prochaine vacation).
Remise en banque des paiements
Les paiements sont remis vers AirPlus la nuit à partir de 00h00, fuseau horaire CET (heure d’Europe Centrale), via un échange de fichier avec AirPlus.
Ouvrir votre contrat d’acceptation AirPlus Logee
Afin de proposer le moyen de paiement AirPlus Logee sur votre site Web, vous devez souscrire un contrat de Vente A Distance auprès d'AirPlus. Vous nous transmettez par la suite le numéro de contrat, ainsi qu'un identifiant de compagnie sur un caractère, fournis par AirPlus, afin de les enregistrer dans notre système d’information.
Devises acceptées
Toutes les devises pourront être acceptées par Worldline Sips (merci de vous référer au paragraphe 'currencyCode' du Dictionnaire des données) à condition qu'elles soient prévues dans un des contrats que vous avez conclus avec AirPlus Logee. Veuillez noter que les contrats AirPlus Logee sont des contrats à devise unique. Cela signifie que vous devez signer un contrat d’acceptation AirPlus Logee pour chaque devise souhaitée.
Effectuer un paiement AirPlus Logee
Worldline Sips vous offre deux solutions pour intégrer le moyen de paiement AirPlus Logee :
- Sips Office qui vous laisse la possibilité d’afficher vous-même vos pages de paiement et qui fonctionne par un dialogue de serveur à serveur.
- Sips Office Batch qui vous permet de traiter des paiements par échange de fichiers.
Les modes de remise disponibles pour une transaction AirPlus Logee sont les suivants :
- Mode annulation : mode forcé, il permet de remiser la transaction à une date prédéfinie, appelée délai de capture. Lorsque ce délai de capture est atteint, la remise est automatiquement envoyée. Ce délai est paramétré via le champ captureDay. Dans le cadre d'AirPlus Logee, sa valeur est forcée à 0 (paiement en fin de journée).
Le diagramme ci-dessous explique les différents états par lesquels peuvent passer les transactions selon le mode de capture choisi :
Effectuer un paiement AirPlus Logee avec Sips Office
Le processus de paiement pour Sips Office est décrit ci-dessous :
Paramétrer la requête de paiement
Il est possible d'initier des paiements Airplus Logee avec la méthode
cardOrder du service CheckOut.
Les champs suivants sont utilisés pour envoyer les informations
spécifiques à ce moyen de paiement :
| Nom du champ | Remarques / règles | ||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
cardCSCValue |
Absent | ||||||||||||||||||||||||||||||||||||||||
cardNumber |
Obligatoire | ||||||||||||||||||||||||||||||||||||||||
cardExpiryDate |
Obligatoire | ||||||||||||||||||||||||||||||||||||||||
customerId |
Obligatoire | ||||||||||||||||||||||||||||||||||||||||
orderId |
Obligatoire | ||||||||||||||||||||||||||||||||||||||||
paymentMeanBrand |
Obligatoire, doit valoir AIRPLUS_LOGEE | ||||||||||||||||||||||||||||||||||||||||
customerContact.firstName |
Facultatif. La concaténation de
ces deux champs doit faire 39 caractères maximum. |
||||||||||||||||||||||||||||||||||||||||
customerContact.lastName |
|||||||||||||||||||||||||||||||||||||||||
transactionOrigin |
Facultatif. 12 caractères
maximum. |
||||||||||||||||||||||||||||||||||||||||
holderContact.firstName |
Facultatif. La concaténation de
ces deux champs doit faire 48 caractères maximum. |
||||||||||||||||||||||||||||||||||||||||
holderContact.LastName |
|||||||||||||||||||||||||||||||||||||||||
journeyData.journeyAmount |
Obligatoire. La somme de tous les
journeyAmount fournis doit être égale au montant de la transaction
(champ amount de la
requête). |
||||||||||||||||||||||||||||||||||||||||
journeyData.journeyModality |
Obligatoire. Valeurs : journeyModality |
||||||||||||||||||||||||||||||||||||||||
journeyData.journeyMode |
Obligatoire. Valeurs : journeyMode |
||||||||||||||||||||||||||||||||||||||||
journeyData.journeyNature |
Obligatoire.
|
||||||||||||||||||||||||||||||||||||||||
journeyData.ticketReference |
Obligatoire. 12 caractères
maximum. |
||||||||||||||||||||||||||||||||||||||||
travelData.numberOfTravelers |
Falcultatif. Valeurs : 1 à 99. |
||||||||||||||||||||||||||||||||||||||||
shoppingCartItem.productCode |
Falcultatif. 30 caractères
maximum. |
||||||||||||||||||||||||||||||||||||||||
shoppingCartItem.productDescription |
Falcultatif. 40 caractères
maximum. |
||||||||||||||||||||||||||||||||||||||||
bookingData.bookingPlatform |
Obligatoire. 40 caractères
maximum. |
||||||||||||||||||||||||||||||||||||||||
bookingData.bookingPlatformOrderId |
Falcultatif. 40 caractères
maximum. |
||||||||||||||||||||||||||||||||||||||||
bookingData.bookingId |
Falcultatif. 30 caractères
maximum. |
||||||||||||||||||||||||||||||||||||||||
bookingData.bookerFirstName |
Facultatif. La concaténation de
ces deux champs doit faire 39 caractères maximum. |
||||||||||||||||||||||||||||||||||||||||
bookingData.bookerLastName |
|||||||||||||||||||||||||||||||||||||||||
merchantOrderSpecificData |
Contient les informations spécifiques d'une commande
qui seront transmises vers l'acquéreur, via la remise en banque,
selon les modalités définies entre le commerçant et AirPlus
(alimentation totalement liée au format du fichier de remise
AirPlus). Voir le tableau dédié
ci-dessous. |
Paramétrer le container merchantOrderSpecificData
Le container merchantOrderSpecificData contient un
ensemble de trois champs permettant d'alimenter des données spécifiques du
fichier de remise AirPlus selon des modalités qui auront été échangées
entre AirPlus et vous.
Voici les conditions d'alimentation générique de ce container :
Valeur du champ merchantOrderSpecificDataType |
Valeur du champ merchantOrderSpecificDataReference |
Format du champ merchantOrderSpecificDataValue |
Description en remise AirPlus |
|---|---|---|---|
| ZIB | C4 | AN8 | Référence commerçant n°1 |
| DD | N6 | Référence commerçant n°4 | |
| E1 | AN17 | Identifiant du passager | |
| B5 | AN17 | Numéro de commande (DBI - AU) | |
| BN | YYYYMMDD | Date de départ (DBI - BD) | |
| JZ | AN17 | Destination (DBI - RZ) | |
| J9 | AN17 | Numéro de projet (DBI - PR) | |
| IW | AN17 | Numéro d'employé (DBI - PK) | |
| GN | AN17 | Centre de coût (DBI - KS) | |
| G1 | AN17 | Compte interne (DBI - IK) | |
| AJ | AN17 | Code action (DBI - AK) | |
| AA | AN17 | Unité d'accompte (DBI - AE) |
Analyser la réponse
Le tableau suivant récapitule les différents cas de réponse à traiter :
| État | Champs de la réponse | Action à réaliser |
|---|---|---|
| Paiement accepté | acquirerResponseCode =
00authorisationId = (voir le
Dictionnaire des données).paymentMeanBrand =
AIRPLUS_LOGEEresponseCode =
00 |
Vous pouvez livrer la commande. |
| Refus acquéreur | acquirerResponseCode = (voir
le Dictionnaire des données).responseCode =
05 |
L’autorisation est refusée pour un motif non lié à la fraude, vous pouvez proposer à votre client de payer avec un autre moyen de paiement en générant une nouvelle requête. |
| Refus suite problème technique | acquirerResponseCode =
90-98responseCode = 90,
99 |
Problème technique temporaire lors du traitement de la transaction. Proposez à votre client de refaire un paiement ultérieurement. |
Pour connaître l'intégralité des codes réponses (responseCode) et codes réponses
acquéreur (acquirerResponseCode), veuillez vous
référer au Dictionnaire des
données.
Gérer vos transactions AirPlus Logee
Opérations de caisse disponibles
Les opérations suivantes sont disponibles sur les transactions AirPlus Logee :
| Gestion de caisse | ||
|---|---|---|
| Annulation | V | Annulation totale uniquement. |
| Validation | X | |
| Remboursement | V | Remboursement total uniquement. |
| Duplication | X | |
| Crédit | V | |
Le diagramme ci-dessous vous permet de savoir quelle opération de gestion de caisse est disponible lorsqu'une transaction est dans un état donné :
Consulter vos transactions AirPlus Logee
Journaux
Les journaux mis à disposition par Worldline Sips vous permettent d’avoir une vision exhaustive et consolidée de vos transactions, opérations de caisse, situation comptable et impayés. Vous pouvez utiliser ces informations pour enrichir votre système d’information.
La disponibilité des transactions AirPlus Logee pour chaque type de journal est récapitulée dans le tableau ci-dessous :
| Disponibilité des journaux | |
|---|---|
| Journal des transactions | V |
| Journal des opérations | V |
| Journal de rapprochement des transactions | X |
| Journal de rapprochement des impayés | X |
paymentMeanBrand est renseigné avec
la valeur AIRPLUS_LOGEE.Sips Office Extranet
Vous pouvez consulter vos transactions AirPlus Logee et effectuer différentes opérations de gestion de caisse grâce à Sips Office Extranet.
