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!