Midoco created an interface to Airplus enabling you to create virtual credit card numbers from within Midoco Midoffice for the Airplus products Virtual Card Classic or Virtual Card Travel Trade. Naturally you would need to have a contract for an Airplus Account Number with Airplus in place to do so.

However, you do not need to have an Airplus acceptance contract in place where you would be a merchant accepting Airplus payments.

In general, a (virtual) credit card is required in the booking process already - so way before the (finished) booking arrives in Midoco. Consequently, the created credit card number needs to be transferred into the booking tool by the agent manually.

Midoco provides the functionality in CRM but also in an order (e.g. in case a card number is needed to book top-ups etc.).

The underlaying Airplus Account can either be the one of the agencies client or the agencies on account.
If it is your agencies Airplus Account being used to create a card, please keep the processes in mind such as making use of a settlement type.

Midoco communicates via a technical user with Airplus in this interface.

Midoco Mode

Mode 1, Mode 2, Mode 3

Mode 1: Mode based on billing documents without accounting functionality, formerly known as VERK

Mode 2: Invoice-based mode with accounting functionality, formerly known as FIBU

Mode 3: Mode based on billing documents with accounting functionality, formerly known as VERK2FIBU

Scope of this directive

Order, CRM

Description

Activating the Interface

Please contact our Helpdesk to get the Airplus Virtual Cards interface activated for your Midoco Org. Unit(s).

Any interface communication with Airplus is done making use of a technical user provided by Midoco GmbH. 

Any credit card created in Midoco Midoffice can be identified by the Generating User being filled by Midoco with:

• Name: your Midoco Org. Units Print Name
• Mail: your Midoco Org. Units E-Mail
• Phone: your Midoco Org. Units Teleohone

Setup

You may be familiar with Midoco´s TAMARA credit card enrichment for virtual credit cards already. This functionality requires the Airplus Account Number of the related Airplus Account to be stored in a Midoco CRM Attribute ID AIRPLUS_VIRTUAL_CARD_ACCOUNT.

When activating the Airplus Virtual Credit Card Creation interface you will get access to a new tab in the CRM profile called 'Virtual Credit Cards'.

This is the place where Midoco expects to find the Airplus Account Number used for creating the virtual cards.

Adding the Airplus Account Number is done by clicking on the '+' tab next to the Overview tab. You are prompted a dialogue where you can enter the Airplus Account Number

Once that is done you will see the tab content changing to:

The Airplus Account Number is displayed on the top again, it can also be cleared from here. Please only hit the button when you are absolutely sure you want to clear this tabs content completely and for good.

The tab also contains a table showing you (filtered by the filters on the left) the created credit cards for this Airplus Account.

By default only active cards (credit cards with a Valid To date >/= today) are displayed.

Create a virtual credit card from CRM profile

In cases where you need to get hold of a virtual credit card number but do not have a corresponding order in Midoco yet you would be using starting off in CRM.

Any information required by Airplus need to be provided manually.

Creating a new virtual card

Start the process by clicking the 'New' button on the left in the 'Virtual Credit Cards' tab in CRM.

 

You are prompted a dialogue where you can enter all the information required for creating a new credit card number.

Any field having a solid yellow background is a mandatory field.

At the top you are presented again with the Airplus Account Number and also the card brand this new credit card is going to have.

In the middle part of that dialogue you will have additional fields coming up depending on the travel type you select.

At the bottom of the dialogue you find the DBI information this Airplus Account Number requires and their validation criteria next to the field. 00-17AN for instance is for an alphanumeric value of 0-17 characters.

The example above indicates that all those fields are desired for cards created from this Airplus Account Number but none of them is mandatory.

After having filled in all information required and desired please confirm using the OK button at the bottom.

Easter Egg: Expert Mode

Optionally you can also work with the AMADEUS style of providing the card parameters like:

in a command line

Should you want to go for the Expert Mode, please ask the Midoco Helpdesk team to enable this feature for you.

On a successful credit card creation you are presented with the dialogue showing you the card number and CVC masked.

PCI DSS mandates that you need to document your business needs to access credit card data and see the PAN unmasked.

In Midoco this business need is facilitated by your Midoco administrator in your TMC providing your user in Midoco with the Password Level = 'Payment Users (incl. CC Data)'

Additionally, your user role needs to have the right to access credit card data.

The button to expose the credit card is activated as soon as you have the password level assigned to your user (else this button is disabled):

Like anywhere else in Midoco Midoffice when accessing an unmasked / untokenised credit card number you have to enter your password again.

On doing so you are able to see the full credit card number and the CVC and can copy the information from here to your clipboard to insert it into the booking tool where you need the card number.

After closing that dialogue you will find the newly created card in the table of the Virtual Credit Cards tab in CRM.
The card number will be displayed tokenised.

Should you need the credit card number again you can double-click the line of the card you need and go to 'Expose' again.

Changing / Adding data for an existing virtual card

Lets suppose you created a card already, fed it into your booking tool and later on you realise that a DBI is wrong or you want to provide an optional DBI which you did not do when creating the card.
Fortunately, you are able to change the information - however, it is vital that you do so prior to the Airplus settlement being issued.

Just select and double click the corresponding card line in CRM (or make use of the 'edit' button) and change the value that needs changing.

You are also able to add DBI information should you have missed out on doing so the first time around.

To confirm the changes just hit 'OK' and the new information is transmitted to Airplus.

You will be shown an information on successful transmission

In case there was an issue and you are presented with an error message please contact Airplus.

Deactivating/Deleting a credit card number

You can deactivate  -  and thus delete from Midoco - an existing virtual credit card which was never used and which you do not need any more. This will also release this cards value from your Airplus accounts limit.

Create a virtual credit card from an order

From within an order you can also create a virtual credit card number for a specific item. You will be able to select if this card number is created from the order customers Airplus Account Number or from another customers (e.g. your TMC´s) Airplus account.

To create virtual credit cards from your clients Airplus account make sure you have their permission and blessing.

In the context menu on an item (right click the item line) you will find 'Create Virtual Credit Card'

Next please decide if this credit card is going to be created from this order customers Airplus Account Number or a different CRM customers profile/Airplus Account Number (e.g. your TMC´s profile).

The selected CRM customer as well as the Airplus Account Number are being displayed in that dialogue.

To finish the selection, please confirm by clicking OK.

In the order information like

• Merchant Name (the suppliers name in order master data) → please change it in case you find it is not correct or sufficiently specified
• Merchant Country (the suppliers address data country in order master data)

as well as basic information such as

• Amount
  • in case it is a client settled item we default to 0.00, please change
  • in case of an agency settled item on FX purchase we preset the FX purchase amount
  • else the items sales price
• Validity Dates
  • From: preset with todays date
  • To: the travel end date + 30d

may be present already and Midoco will set the data for you where available.

The Travel Type - as there is no 1:1 mapping possible between Midoco´s and Airplus´ travel types would need to be selected manually.

After confiming the data entered by clicking OK you will get the credit card number.

This time - because there is an order relation - you can choose:

• to copy this credit card directly to this orders form of payment (because it´s your clients credit card which they allowed you to charge for this order) → this process does not require you to expose the unmasked card number
• to expose the card number and copy the data into your booking tool.

Of course, a credit card created this way is also shown in the CRM profile of the corresponding Airplus Account Number.

A card being created from an order has a link to this order and you can jump from CRM into that order again using the 'Show' button.

When the credit card created in Midoco CRM (so no order relation yet) is contained in a booking message we establish the link between the order and the CRM profiles Virtual Credit Card line.

Changing / Adding data for an existing virtual card

To change or add data to a virtual card created from an order or to deactivate such a card, please go to the corresponding CRM profile and follow the steps described above:

• Changing/Adding data for an existing virtual card
• Deactivating/Deleting a credit card number

Related pages

• Page: Hedging
• Page: EU Travel Directive Functionality in Midoco
• Page: Umbrella Profiles Synchronization
• Page: Midoco Webservice Accounting Export
• Page: Pliant Virtual Card Creation

GLOBAL-1232 - Airplus XML Interface: Create virtual card numbers Geschlossen