Skip to main content

Veritran Docs

SmartPos

The SmartPos API allows you to connect to a smart POS terminal and process payments, print receipts, retrieve device information and perform cryptography-related actions, among other functions.

To integrate the POS manufacturer's SDK library into your app, you must add a wrapper library (lib_pos_wrapper) that works as a generic interface and enables the connection between the manufacturer's SDK and the Veritran platform.

Important

This documentation doesn't include the POS manufacturers' SDK configurations. To learn about these configurations, refer to the POS manufacturer's documentation.

The advantages of this integration include:

  • Combining traditional POS terminals with Android technology by connecting the terminal to an app built in Studio.

  • Supporting a wide range of POS terminals while using a generic interface.

  • Making use of the additional physical capacities provided by the POS technology through the Call API's simple interactions.

Note

The integration described in this article may not be implemented in your environment or enabled for all your clients. Contact your admin for assistance.

Technical Details

API ID

597

API Code

SMARTPOS

Call API version

1.0

SDK Version

Android: 8.1 and 10 (SafeDroid)

App Version

7.6 onwards

Objective

Connection and interaction with a POS terminal

Classification

SmartPos devices

Available for

Android - Urovo (i9000s, i2000 and i9100)

Use the SmartPos Integration in Studio

The following functions are available for use in your legacy processes, and you can also use them as blocks in Lambda processes. Functions are categorized here according to the process they are involved in: terminal information retrieval, receipt printing, cryptography and payment processing. Click each function to see more details.

Get POS Parameter

Access the device's information and verify the status of each of its components.

terminal information retrieval

Print

Print images, texts and barcodes (QR or EAN) using the thermal receipt printer.

receipt printing

Get Key Information

Retrieve detailed information about the key stored in the selected safe slot.

cryptography

Get Pin

Access the cryptoprocessor and request an encrypted pin.

cryptography

Mockup Load Dukpt Key

Load a 3DES DUKPT key in the selected slot.

cryptography

Mockup Load Master Key

Load a 3DES master-session key in the selected slot.

cryptography

Load Card Parameters

Load the parameters necessary to use a card reader. This function only needs to be executed once, when starting the app, for the reader to work.

payment processing

Set EMV Tag List

Load an EMV tag list into the kernel to process a transaction.

payment processing

Partial Grade

Perform a chip card validation before GPO.

payment processing

Get EMV Tag Value

Retrieve an EMV tag value.

payment processing

Full Grade Before Online Processing

Complete the payment operation and send the financial institution's response to the card.

payment processing

Get EMV Tag List TLV

Retrieve a list of EMV tags in TLV format and send those tags to the kernel.

payment processing

Full Grade Completion

Complete the payment operation and send the financial institution's response to the card.

payment processing

Payment Finish

Finish a card transaction, prompt the user to remove the card and restart payment data.

payment processing

Important

If you have any questions, contact your admin before proceeding with the configuration of a function.