Frequently Asked Questions about CloudWalk

  1. Device
  2. Development
  3. Communication
  4. Contracts and Services

Device

How do I setup the device communication?

There is an interactive wizard that will guide you through the whole setup process:

  1. First, press the device Function button (F for Ingenico, F1 for Verifone);
  2. Enter the password (default is 55555);
  3. On the setup menu, select the option DEVICE SETTINGS;
  4. Then select the option COMMUNICATION;
  5. Now you can choose the communication type and fill in the required information.

Can I add new files (images, text, etc.) to a device?

Yes. This process can be done in four steps:

  1. Go to the File management section and upload the files;
  2. Go to the Application management section and edit the application that will make use of those files;
  3. Check the files on the Application files list and update the app;
  4. Now, assuming that your device is associated with the app that you've just added the files, you can update your device and the new files will be downloaded.

How do I clean a device?

  1. First, press the device Function button (F for Ingenico, F1 for Verifone);
  2. Enter the password (default is 55555);
  3. On the setup menu, select the option CLOUDWALK;
  4. Then select the option DELETE APPS.

What is the most suitable device for my needs?

That depends on the project, but in general, before purchasing a device, make sure that it meets the project requirements. For example, if mobility is an important factor, a device with GPRS should be considered. It's also necessary to ensure that the device is compatible with CloudWalk.

Which devices are compatible with CloudWalk?

Check out the approved devices list.

Is it possible to have many applications on the same device?

Yes, that's perfectly possible, since CloudWalk devices are prepared to handle multiple POSXML applications. If a device was configured to have access to a single application, when the green button is pressed, that application is automatically started. However, if the device have access to multiple applications, when the green button is pressed, a menu listing all of the applications is displayed, so you can choose one of them to start.

The Group management section defines which applications should be accessible to a group. After configuring a group, any amount of logical numbers can be assigned to that group, through the Logical numbers section.

How do I setup a basic integration between my device and an endpoint?

Check out the HTTP integration example.

What is the password to access the configuration menu?

The default password is 55555.

Is it possible to change the default configuration menu password?

Yes, check out the password change guide.

How do I check the device serial number and where do I register it?

  1. First, press the device Function button (F for Ingenico, F1 for Verifone);
  2. Enter the password (default is 55555);
  3. On the setup menu, select the option DEVICE SETTINGS;
  4. Then select the option SERIAL NUMBER;
  5. The serial number registration is done through the Device management section.

How do I reset the certificate already installed on Verifone EVO terminals?

Get in touch with your POS terminal supplier and request a reset file, which then can be used to reset the certificate.

What may be preventing the device from downloading a new file?

Check the following points:

  1. If it's an application or module, certify that the deploy was successful;
  2. If it's common file or image, ensure that the file was properly uploaded. You can also clear the browser's cache and upload the file again to avoid any browser miss behaviours.

Development

What is the CloudWalk Manager?

The CloudWalk Manager is a tool used to grant access to devices, register applications, files, logical numbers and groups. It is also through this tool that user management and transactions monitoring is done.

How is the CloudWalk development environment?

The Cloudwalk service provides a simple, fast and intuitive development environment accessible to anyone using a web browser, it provides the innovative use of real-time collaboration, by which multiple developers can work on the same application simultaneously.

Further reading: IDE overview

What is POSXML?

POSXML (acronym for Point Of Sale eXtended Markup Language) is a programming language that is used to create applications for POS terminals.

Normally the programming language used to develop POS terminal applications is C or C++, which requires an in-depth knowledge of both the technical specifications of the machine (Hardware) and the programming language.

The main purpose of POSXML is to simplify the development of applications for POS terminals. It contains a set of instructions and pre-programmed commands, which allow direct interaction with the device, resulting in a large reduction in application development time.

What is the maximum size of a String in POSXML?

The maximum size of a String is 1024 bytes.

Are there reserved characters or words in the POSXML language?

All reserved characters in XML are also reserved in POSXML and should be written in the correct way.

The following symbols on the left should be written as they appear on the right:

< &lt;
> &gt;
& &amp;
' &apos;
" &quot;

There are more information about the POSXML structure.

Does CloudWalk supports ISO8583?

translation missing: en.help.faq.development.answer_6.paragraph_1

translation missing: en.help.faq.development.answer_6.paragraph_2

Is there a sample bitmap.dat file for ISO8583 transactions?

Yes, there is a sample bitmap.dat file which you can use as an entry point, but you should check and update the parameters and the type of each bit according to your ISO8583 host specification before downloading it to your devices.

Is there a comprehensive list of POSXML commands?

Yes, there is a comprehensive list of POSXML commands. However, if you are having a hard time to figure out how to tackle a specific situation, drop us a note and we will help you out.

How do I set a custom background image on my device home screen?

Due the diversity of all CloudWalk supported devices, to use a custom background image, it is necessary to follow a set of rules in order to achieve the best results for a given device.

Device model Bitmap type Filename Sample
Verifone VX 680, VX 685, VX 820 Color (243 x 276) walk.bmp View
Verifone Verix 510, VX 520 Monochromatic (119 x 57) walk.bmp View
Ingenico iWL280 Color (245 x 156) walk.bmp View
Ingenico iCT250, iWL250, iPP350 Color (288 x 156) walk.bmp View
Ingenico iCT220, iPP320 Monochromatic (119 x 57) walk.bmp View

After creating your custom image, follow these steps:

  1. Go to the File management section and upload your custom bitmap image, following the naming convention on the table above.
  2. Go to the Application management and edit your application;
  3. Check the bitmap file that was previously submitted on the Application files list and update the app;
  4. Now, assuming that your device is associated with the app that you've just added the bitmap, you can update your device and the new background will be displayed.

Note: Only bitmap (.bmp) images are supported. Other formats like JPG, GIF and PNG are not supported.

What is the authorizer server (host)?

Authorizer is the component responsible to verify and validate the information provided by POS terminals.

Further reading: Authorizer

How do I set the authorizer's endpoint?

The endpoint is configured at the application level, through the following steps:

  1. Go to the Application management and edit your application;
  2. Set the endpoint, which can be http, https, tcp, tcps, etc;
  3. Now, assuming that your device is associated with the app that you've just set the endpoint, you are good to go, because once a transaction is performed, the data being sent will be forwarded to the new endpoint URL.

Is it possible to set multiple endpoints to an app?

No. An application can be associated to only one endpoint. Note that the modules being used by an application will automatically use that application's endpoint.

However, if you need to communicate with multiple endpoints on the same application, you can follow these steps:

  1. Create your main application (example, myapp.posxml) poiting to one of the endpoints (example, https://my-endpoint.com);
  2. Create a new application (example, activation.posxml) poiting to another endpoint (example, https://activation.com), and on this application, the Label should be to x, indicating that this app will be hidden. Note that this application should be responsible for the complete communication workflow, including preconnect, network.send, network.receive and network.hostdisconnect;
  3. Repeat the step above as you need, creating hidden apps for all your endpoints;
  4. Now, on the main application (myapp.posxml), you can use the command execute, which will execute one of your hidden apps, communicating with the desired endpoint.

The CloudWalk platform has an API?

Yes! Check out the API section for more information.

Communication

Which communication types are supported?

That depends on the device, but in general, Ethernet, GPRS and dialed is supported.

How do I setup my Ethernet device to use DHCP?

That's quite simple! All you have to do is set the IP to 0.0.0.0. After restarting the device, an IP should be automatically assigned to it.

When using GPRS, which APN, user and password should be set?

First you need to check if your GPRS SIM card uses private or public APN. You can get this information with your SIM card provider.

If you have acquired the chip through a telecommunication company such as Lyra Network, it will probably use a private APN, otherwise it should use a public APN. The username and password should also be requested with your SIM card provider.

Brazilian customers can take advantage of some pre-configured providers (CLARO, TIM, OI, VIVO, LYRA, etc), while customers outside Brazil should pick the option Other operator and manually enter the information.

Why my device is not connecting?

In general, you can assume that our service is always up. If you are not sure, just check our status page. So assuming that our service is up, communication problems should be related to your POS, your infrastructure or some sort of configuration.

POS problems

When troubleshooting communication problems, it is essential to narrow the range of possibilities, and you should start by making sure that your device is working properly.

Infrastructure problems

After making sure that your device your working, you should check your infraestructure.

  1. Make sure your host (your endpoint) is active and responding to requests.
  2. For Ethernet and wi-fi devices, make sure your network connection is active and check if you can access the Internet with a laptop or a smartphone on that network.
  3. For Ethernet and wi-fi devices, make sure there are no restrictions or rules (firewall) on the network that may block the connection.
  4. For Ethernet and dial devices, make sure that the cable is not damaged and that it is properly connected on both extremities.
  5. For GPRS devices, check the signal and make sure the SIM card is operating normally (try in other devices). If it is prepaid, check if it has credit.

Configuration problems

Assuming that the problem is not related to your device (physical problem) and that your infraestructure is fine, it can only be some sort of configuration problem:

  1. Make sure that your device serial number is properly registered on the Devices management.
  2. For Ethernet and wi-fi devices on a DHCP network, the IP should be set to 0.0.0.0, so it will be assigned by the DHCP client.
  3. For Ethernet and wi-fi devices, make sure that you have set the correct values for Network Mask (e.g. 255.255.255.0), Gateway (e.g. 192.168.1.1), DNS 1 (e.g. 8.8.8.8), DNS 2 (e.g. 8.8.4.4) and SSL (e.g. 0).
  4. For GPRS devices, double check the APN configuration. You might need to get in touch with your telecomunications provider to make sure that everything is correct.

Contracts and Services

What is a transaction?

A transaction is defined by any data message from approved and certified POS equipment with the CloudWalk Framework and an operational application installed that is integrated with CloudWalk's servers and our customer's authorisers, via an applicable telecommunications channel.

Note: all transactions conform to PCI standards and additional CloudWalk security protocols, being private and exclusively accessible by the customer.

Do CloudWalk sell POS terminals?

No, CloudWalk provides only the service. However, if you need to buy POS terminals, you can get in touch and we will be more than happy to help you out!

Is the authorizer server included with the CloudWalk service?

No, authorizer development and maintenance is the customer's responsibility.