FAQ - SDK¶
Where can I find the PayStore documentation?
The PayStore documentation (API, SDK, Android) must be accessed through the PayStore Portal. To access it, you need to log in with your developer credentials.
What is the development environment (IDE) used by PayStore ?
We recommend using Android Studio.
Where can I find the sample lib and projects?
The lib and sample projects can be accessed via the link GitHub PayStore
Can I use the same configuration from one terminal in another ?
Not. Each terminal needs a unique number previously registered. Otherwise, the message "Invalid Sequence" will be displayed.
I can't make transactions or initialize the terminal. What could it be ?
Contact Support.
To install the application on a physical terminal, do you need an SD card?
Not. Conventional terminals do not support SD card.
If the load is on your machine, use a USB or serial cable, depending on the terminal model.
Verifone terminals support USB flash drive charging.
PAX terminals **don't** support USB flash drive charging.
The terminal is displaying "Invalid Serial Number". What could it be ?
Probably, the registration of this terminal in the PayStore is missing. Request that your terminal be registered.
If the problem persists, contact Support.
Why is the "Bad request" error occurring?
Contact Support with the date, time and serial number of the device, so that we can investigate the cause of this problem.
Is there any way to update the application without using USB ?
Yup. Through the remote charging system, called PhDM, it is possible to carry out charges at the terminal remotely. However, depending on the version installed on the terminal, this process can only be done for terminals that have already started.
If the need is just to install an App, just place it in the App Store to be downloaded in the terminal, without having to load it locally or perform a remote update on the terminal.
Is it possible to carry out the first charge via the "PhDM" telecharge system?
Not. The first charge must be done by local charge, via USB or serial.
Which application should I initially load in the terminal?
You will receive a package that contains the following applications:
- Payments.apk
- Acquirer.apk
- Platform.apk
- PaystoreClient.apk
This application package is made available by the Support team.
How do I load the application in the terminal ?
The application must be loaded via ADB. For more information consult the documentation, option start here.
Where can I get the Windows drivers to load the terminals via USB?
Contact the manufacturer or supplier of your terminals to order drivers.
Can I make a sale by entering the credit or debit card number ?
It depends. If the acquirer allows typed transactions, yes. For example, Global Payments and Adiq allow typed transactions. Stone, on the other hand, usually doesn't allow it.
Contact your purchaser and check the conditions for activating this modality at the establishment. This involves risk analysis of the establishment.
Why is the message "Manual operation not allowed" ?
Most likely, you tried to make a typed sales transaction and the acquirer does not allow it.
How can I simulate capturing a card in the virtual terminal (Emulator) ?
It is not possible to simulate capturing a card using the emulator. Currently, this is only possible through a physical terminal.
When I publish an app I've developed, is it available for all PayStore terminals or just for my company's terminals?
Your app will only be available to the endpoints on your network. These visibility levels can be configurable through the PayStore. This setting is called "Publication Filters" and can be applied by City, Fields of Activity, Group of Tenants or specific Terminals.
Can I set the establishment number according to my customer's ID?
Yes, at PayStore through the Facilitator Portal, you can define the establishment identifier in the register of shopkeepers in a very simple way.
Can I change the order of capturing the information, for example, capturing the value before swiping the card?
Yes, just capture the amount before calling the payment API.
Can I change the logo on my voucher?
Yes, this logo can be changed on the PayStore Portal.
How can I add extra information to the terminal, such as "my clients ID" ?
To add information to the terminal, access the PayStore Portal, in the "Settings" menu, select the "Additional Fields" option.
How to capture the information of an Additional Field ?
See the documentation.
Is it possible to change or add information to the voucher?
That depends on the acquirer. Some acquirers send the receipt already formatted to be printed at the terminal. For other acquirers, it is possible to create the voucher on the TEF Server, positioning and formatting the information as desired.
PayStore also supports printing graphical receipts. In this case, the POS terminal uses the information sent by the acquirer or TEF Server, to format the receipts using a graphic layout. In the graphic layout, the developer has complete freedom to build the voucher.
In any case, the change in vouchers or the use of graphic vouchers must be submitted for validation by the acquirer, since the mischaracterization of the voucher (model) can be seen as a possible problem for future actions, such as difficulty in identifying transactions in the call centers, possible blocking of the flags regarding the data informed in the voucher, etc. By default, acquirers typically require that all information on their original voucher be preserved on the subacquirer's customized voucher.