Skip to main content

WPI Codelabs

Practical, hands-on tutorials to help you implement the Worldline Payment Interface in your SmartPOS applications. Each codelab provides step-by-step guidelines on how to develop new features using WPI.

Available Codelabs​

Create First Application with WPI

Duration: ~31 minutes

Learn the fundamentals of WPI integration by building your first payment application. This codelab covers:
- Setting up the Android project
- Understanding WPI request/response structure
- Implementing a basic sale transaction
- Handling payment responses
Retrieve Payment Information

Duration: ~31 minutes

Learn how to query the payment solution for configuration and capabilities using the WPI background service. This codelab covers:
- Using Android Messenger Service for background operations
- Binding to the WPI information service
- Retrieving terminal configuration
- Parsing payment solution capabilities
Retry Logic for WPI Payment Information

Duration: ~39 minutes

Implement robust retry mechanisms for your WPI integration. This codelab covers:
- Exponential backoff retry strategies
- ViewModel-based UI state management
- Service disconnection handling
- User feedback during retries

Getting Started​

1
Set Up Your Development Environment

Ensure you have Android Studio installed and configured for SmartPOS development. - Android Studio Narwhal Feature Drop or later - SDK 36 or higher - Gradle 8.14.3 or higher

2
Get Your Test Terminal

Request a test terminal from your Worldline Partner Manager.

3
Verify Payment Application

Ensure you have a payment application running on your device before starting the codelabs.

Prerequisites​

Before starting any codelab, ensure you have:

  • Android Studio - Latest version recommended
  • SmartPOS Device or Emulator - For testing your applications
  • Payment Application - Running on your test device
  • Basic Kotlin Knowledge - Familiarity with Android development

Code Samples​

Each codelab provides downloadable starter code and finished solutions:

We aim to add more content to this section frequently. If you are interested in developing your knowledge about WPI and its new features, please visit us again soon!