WL SIPS DOCS

Release 22.5

aller directement au contenu

Rechercher par mots clés

Intégration AirPlus Logee

Pour rechercher dans la page utiliser Ctrl+F sur votre clavier

WL 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 WL Sips.

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 WL Sips, nous vous conseillons de consulter les documents suivants :

  • Présentation fonctionnelle
  • Guide de configuration des fonctionnalités

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.
Attention : L'ajout du moyen de paiement AirPlus Logee sur votre boutique impose la mise en place d'une remise en banque dédiée et est donc soumis à projet. Si vous êtes intéressé par ce moyen de paiement, veuillez vous adresser au support commerçant.
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

La durée d’autorisation pour les cartes AirPlus Logee est forcée à 0 jour (remise en banque à la prochaine vacation).

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.

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.

Toutes les devises pourront être acceptées par WL 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.

WL 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 :


Description des statuts possibles pour une transaction AirPlus Logee

En mode annulation (captureMode = AUTHOR_CAPTURE), si la transaction est acceptée et que le délai de capture (captureDay) n’est pas dépassé, la transaction passe en statut TO_CAPTURE. Quel que soit le mode de capture, si la transaction est refusée (responseCode différent de 00), elle passe en status REFUSED.

Le processus de paiement pour Sips Office est décrit ci-dessous :


étapes d'un paiement AirPlus Logee via Office

1) Le client effectue un paiement sur votre site. 2) Vous récupérez les informations carte AirPlus sur votre serveur. 3) Vous transmettez la demande d'autorisation à WL Sips et WL Sips vous renvoie une réponse contenant le résultat du paiement. 4) Vous affichez le résultat du paiement à votre client.

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.
Valeur possible Description
01 Seat
02 Bed
03 Parking space
04 Domestic Ticket
05 International Ticket
06 Underground
07 Bus, Car, Taxi
08 RailCard / Abonnement
09 Ferry / Ship
10 Cancellation/Refund with Fee
11 Cancellation/Refund without Fee
12 PromoCode, Coupon
13 Meal
14 Internet
15 Miscellaneous (Merchandise,…)
70 Service Fee
71 Merchant Fee
72 Delivery Fee
99 Routing Information
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.

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 merchantOrderSpecificType Valeur du champ merchantOrderSpecificReference Format du champ merchantOrderSpecificValue 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)
Remarque : DBI ("Descriptive Billing Information") : informations descriptives de facturation. Correspond à des champs affichés dans les éléments de factures détaillées côté AirPlus Logee. Les codes indiqués dans le tableau correspondent aux codes des champs que vous retrouverez dans l'interface AirPlus.

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 = 00
authorisationId = (voir le Dictionnaire des données).
paymentMeanBrand = AIRPLUS_LOGEE
Vous pouvez livrer la commande.
Refus acquéreur acquirerResponseCode = (voir le Dictionnaire des données). 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-98
responseCode = 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.

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é :


description des status possibles pour une transaction AirPlus Logee

En attente de capture (statut TO_CAPTURE), la transaction peut être totalement annulée et passe alors en statut CANCELLED. Dans le cas contraire, elle est automatiquement envoyée en banque est passe à l'état CAPTURED. En état CAPTURED, la transaction peut être totalement remboursée et passe alors en statut CREDITED.

Les journaux mis à disposition par WL 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
Remarque : pour les transactions AirPlus Logee, le champ paymentMeanBrand est renseigné avec la valeur AIRPLUS_LOGEE.

Vous pouvez consulter vos transactions AirPlus Logee et effectuer différentes opérations de gestion de caisse grâce à Sips Office Extranet.



Ce site utilise des traceurs pour améliorer votre expérience de navigation, effectuer des analyses et des recherches sur votre utilisation du site web de documentation WL Sips.
En fermant ce bandeau vous refusez notre utilisation des traceurs sur votre appareil.

Paramètres