Worldline Payment Interface

Version: 2.2 | Revision #2

Table of Contents

1. Overview
2. Interface Structure
3. Interface Description
4. Data Dictionary
5. Payment Solution Implementation

1.Overview

The Worldline Payment Interface (WPI) is an Android intent-based interface that enables easy and fast integration with payment apps. It is designed to allow additional business applications to execute payments on any Worldline offered SmartPOS device. A SmartPOS device is a payment device that runs Android.

All Worldline Payment Solutions support WPI, which means that business applications that use this interface can run everywhere without any change of code. This makes it easy for developers to build payment apps that are compatible with a wide range of payment devices and payment protocols.

The WPI interface is built on top of the Android Intent mechanism, which allows different parts of an app to communicate with each other in a structured way. By using intents to trigger payment-related actions, the WPI interface simplifies the payment integration process and makes it easier for developers to build business applications on top of Payment Solutions.

1.1 What's New

• Information functional extensions:
  • Conditions for ShopInfo added
  • Conditions for PaymentInformationItem added
• Management functional extensions:
  • Payment Solution Information request
    • supportsManualPanKeyEntry flag added
    • supportsTip flag added

2. Interface Structure

The WPI provides a set of intents that developers can use to build apps that work with the interface. The following table lists each intent, along with its purpose:

Type	Category	Intent	Purpose
Financial	Display Action	com.worldline.payment.action.PROCESS_TRANSACTION	Process a financial transaction
Management	Display Action	com.worldline.payment.action.PROCESS_MANAGEMENT	Trigger payment solution managed actions
Information	Background Action	com.worldline.payment.action.PROCESS_INFORMATION	Background management of payment solution specific information

4. Data Dictionary

4.2.5 Receipt

formatted: {
	"merchant":"    This is to confirm your transaction\\n
		registered at:\\n
	    ----------------------------------------\\n
				 SPS-Softpos Pilot 02\\n
				  Grzybowska 4/246\\n
				   00-131 Warszawa\\n
		----------------------------------------\\n
		15.02.2023 22:36\\n
		0,03 PLN\\n
		Visa **** **** **** 7984\\n
				Transaction details: \\n 
	    Status:                       AUTHORIZED\\n
		Authorization code:           (0) 741451\\n
		ARQC:                   61BC5EDC34F63979\\n
		AID:                      A0000000031010\\n
		Contactless\\n
		Type:                               Sale\\n
		POS ID:                         APP00002\\n
		MID:                           103810047\\n
		VISA CARD",
	"client":"    This is to confirm your transaction\\n
		registered at:\\n
	    ----------------------------------------\\n
				 SPS-Softpos Pilot 02\\n
				  Grzybowska 4/246\\n
				   00-131 Warszawa\\n
		----------------------------------------\\n
		15.02.2023 22:36\\n
		0,03 PLN\\n
		Visa **** **** **** 7984\\n
				Transaction details: \\n 
	    Status:                       AUTHORIZED\\n
		Authorization code:           (0) 741451\\n
		ARQC:                   61BC5EDC34F63979\\n
		AID:                      A0000000031010\\n
		Contactless\\n
		Type:                               Sale\\n
		POS ID:                         APP00002\\n
		MID:                           103810047\\n
		VISA CARD"
	}
}