Embedded Payment SDK
Getting Started
Embedded Payment SDK Intro

Embedded Payment SDK

The Embedded Payment SDK works with MineSec Access Gateway, which processes each transaction and routes it to your payment host or acquirer. Check out more details on Access Gateway.

The MineSec Embedded Payment SDK (a.k.a. Headless SDK) is designed to simplify the development of SoftPOS applications by providing essential functionalities while allowing maximum customizability. This SDK abstracts the complexity of setting up and managing the underlying MPoC Isolated SDK, enabling developers to focus on crafting unique merchant experiences.

Architecture

Embedded Payment SDK architecture

  • Your app embeds the Embedded Payment SDK, which holds the payment kernels and security protection. Your business logic stays in your app.
  • Security services (Attestation & Monitoring, Key Management) always run in the MineSec environment.
  • Payment & management services (Access Gateway, TMS, value-added services) run as SaaS, or on-premise on request.
  • Your environment connects through the integration connection to your payment host or acquirer, and through the Service API to your back-office systems.

Platform Support

The Embedded Payment SDK is available on Android, iOS and PCI PTS payment terminals:

  • Android
    • Fully customizable UI using Jetpack Compose or XML Views
    • Offers a headless architecture for deep UX integration
    • Designed for building highly tailored merchant experiences
  • PCI PTS Payment Terminals
    • Supports PCI PTS-approved payment terminals (PIN Transaction Security) with built-in card readers and secure PIN entry
    • Same headless architecture and payment APIs as the Android edition
    • Supported terminals:
      1. Newland N950
      2. Landi P-series (P30 / P10)
      3. Sunmi P3
  • iOS
    • Provides the same core payment APIs and capabilities
    • Relies on Apple's built-in Tap to Pay on iPhone UI for card reading
    • This card reading UI is fully controlled by Apple and cannot be customized
    • The SDK does not provide UI components on iOS — your app handles all non-payment UI/UX
    • The SDK focuses purely on payment logic, orchestration, and secure processing

Features

  • Simplified Integration: Easy to wire up, initialize, and manage the lifecycle of the MPoC Isolated SDK.
  • Composable UI: Leverages Compose for customizability, allowing developers to pass UI components (composable or XML view) for a seamless integration.
  • Comprehensive APIs: Provides intuitive APIs for essential SoftPOS functionalities, reducing the need for in-depth PCI/ SoftPOS/ EMV knowledge.
  • PCI Compliant: Built on the PCI MPoC certified MPoC Isolated SDK, providing secure and reliable payment processing.

Secure by Default

  • All transactions are secure with PCI-compliant encryption and attack protection inherited from the MPoC Isolated SDK.
  • Automatic, robust handling of sensitive operations like PIN entry, card reading, and transaction processing.

Customizability and Flexibility

  • Headless Architecture: Allows developers to build custom merchant experiences by providing your UI in code directly.
  • Seamless Integration into Existing Apps: In contrast to MineSec Pay 7, the Embedded Payment SDK can be integrated directly into your existing business app, eliminating the need to install a separate SoftPOS application.
  • Seamless Backend Integration: It's integrated with Access Gateway, which holds the information required to build payment messages for your acquirer host or payment gateway.

Quick Time-to-market

  • Developer-Friendly: Reduces development time and effort with its streamlined setup and easy-to-use APIs.
  • Flexible Implementation: Suitable for a variety of merchant use cases, from basic payment acceptance to more complex, customized solutions.

The Embedded Payment SDK is the ideal solution for developers looking to create secure, PCI-compliant SoftPOS applications with a high degree of customizability and a quick time-to-market.

Default UI

Awaiting card
Processing
Signature panel