worldline

Documentation

FAQ

Here you can find most common issues and troubleshooting for Tap on Mobile apps.

General Information

You need to have a device with 

  • Android software version 12 or higher (older versions are no longer supported with security patches by Android),

  • Active internet connection,

  • NFC module,

  • Google support with access to the Google Play store and Google Mobile Services, 

  • Device cannot be rooted. This means that the device may not be enabled to side-load apps and install apps from another device (e.g. a PC), 

  • Hardware-safe memory module and no overlaying applications or processes can run on the device,

  • Grant all the required approvals and permissions as described in the user guide.

In the Google Play store, When installing Tap on Mobile latest android app, ToM will run a device verification and check if your device is compatible or not.

Apple has recently released Tap to Pay in different countries, including Australia, Austria (with Payone), Belgium, Croatia, Cyprus, Czech Republich (with KB Smart), France, Germany (with Payone), Hungary, Italy, Luxemburg, The Netherlands, Poland, Slovakia, Slovenia and Switzerland

PIN online: when a PIN is encrypted and verified online with the card issuer. The traditional method (offline) is when a PIN is verified with the EMV chip card physically entered into a card reader. 

Pin on Glass on the other hand refers to a PIN entry on a touchscreen of a payment PCI-certified device (w/o physical keypad).

You can find all specifications:

  • WPI

  • WMI

  • SDK iOs

And all ressources:

  • Sandbox APK

In the google drive shared during your onboarding: here


Payment

Worldline Tap on Mobile supports the following payment schemes: 

  • Visa

  • V Pay

  • Mastercard

  • Maestro

  • Debit MC

  • Visa Debit

  • Alipay+*

  • Wechat Pay*

  • Twint (Switzerland)*

  • Payconic (Belgium)*

*can not be tested in sandbox but only in production

Worldline Tap on Mobile only accepts contactless payments by card with contactless chip (no contactless magstripe), phone or wearable.

Meal vouchers are not currently supported. 

The team is strongly committed to bringing new features to Tap on Mobile to best meet our clients and prospects' requirements. Stay tuned.

During the installation of Tap on Mobile, the merchant is asked to also install a Worldline Tap on Mobile Pinpad app, which is necessary for enabling PIN authorization (for high-value payments). This is one of the product’s USPs – supporting PIN on Glass.

You can perform the following actions on a transaction via Worldline Tap on Mobile: purchase, cancellation (reversal) and refund (from 0 to 100% of the transaction).

DCC is currently supported with version 4.1.39

The transaction history can be viewed on the Worldline Tap on Mobile app and also on the online portal. There are no limitations to the transactions that are shown.

Each terminal ID has its own transaction history. It is not possible to hide the transaction history in the app.

A digital payment receipt can be sent via email, or the cardholder can scan a QR code to receive the receipt.

Options are as follows:

Standalone:

  • Use the receipt provided within the app (email or QR-Code). If the merchant wants to print it, they can email it to a PC or similar device and print it or scan the QR-Code and print the Webpage,

  • Use the receipt that the cash register provides (in this case, Tap on Mobile is only used as a payment terminal).

Simple integration (WPI):

  • Use the receipt provided within the app (email or QR-Code). If the merchant wants to print it, they can email it to a PC or similar device and print it or scan the QR-Code and print the Webpage,

  • (A cash register does not make sense in a WPI integration case - the goods are registered in a merchant app, not in a cash register),

  • Print the receipt from the merchant app (WPI returns all fields needed to create a receipt, on top of that the merchant has the list of goods from their app, possibly some loyalty details, etc.),

  • Create their own receipt solution based on the information provided by WPI.

Technical Topics

The business app package name is not known by Tap on Mobile backend. Your package name needs to be whitelisted in development to have access to the development backend and in production to have access to the production backend. Please contact us via the tech support form.

The transaction receipt width is predefined by the payment application (40 characters) in the field formattedReceipt.
There is no parameter to define the width of the receipt in tap on mobile.
However, you can analyze the receipt and reformat it in your application as you need it to be. We provide in the receipt all the fields needed for you to generate the receipt as you wish.

There is no receipt for reversal in Tap on Mobile, however if needed you can generate one.

AID

Card Brand

Card Name

A0000000031010

Visa

Visa Debit/Credit

A0000000032010

Visa

Visa Electron

A0000000032020

Visa

Vpay

A0000000041010

Mastercard

Mastercard Debit/credit

A0000000049999

Mastercard

Mastercard Debit/credit

A0000000043060

Mastercard

Maestro

A00000038410

Eftpos

Eftpos savings

A00000038420

Eftpos

Eftpos cheque

As Worldline is available on many markets, there are separated apps dedicated for particular Worldline acquirers:

Acquirer

Android Package name

Region of availability

Worldline EU

eu.softpos.softposwrapper.wl

European Union

Worldline CH

eu.softpos.softposwrapper.wl

Switzerland

Payone

eu.softpos.softposwrapper.payone

Austria; Germany

KB Smart

eu.softpos.softposwrapper.kb

Czech Republic

ANZ Worldline

eu.softpos.softposwrapper.wlanz

Australia

Yes it is, you can use Tom backend via API.

Please have a look on the two links below:

Please also contact tom_integration@worldline.com for this process, it requires an account creation.