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:
Swagger (for merchant API): https://demo1.softpos.eu/v3/api-docs
Visualization of swagger: https://demo1.softpos.eu/swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config (put /v3/api-docs in “explore window”)
Please also contact tom_integration@worldline.com for this process, it requires an account creation.