Solutions
Embed Payments in Your App

Embed Payments in Your App

For PSPs and ISVs who want to accept card payments in their own app without handling the card transaction flow. Your app passes an amount to the Embedded Payment SDK. The SDK reads the card, takes the PIN, sends the transaction to the MineSec backend for processing with your acquirer, and returns the result to your app.

What you integrate

App
Your app's UI and business logic
Transaction processing
Access GatewayMineSec-built host integration
TMS
TMS PortalTMS API
Optional: your own calls to the TMS API
Attestation & Monitoring
—

SDK editions

The Embedded Payment SDK is available in several editions. All editions give your app the same payment API; each edition runs on a different kind of device.

  • SoftPOS edition: runs on Android and iOS phones. Documented on this site.
  • PCI terminal editions: run on Landi, Sunmi and Newland payment terminals. Contact MineSec for documentation.

Steps

Get the SDK

Contact MineSec to obtain the Embedded Payment SDK edition for your devices and your onboarding credentials.

Integrate the SDK into your app

Check the Setup Requirements, then follow the Quickstart. The API Reference covers the SDK setup and payment requests, and the Customization Guide covers the payment UI.

Connect to your acquirer host

Choose how the MineSec backend reaches your acquirer or payment host:

  • MineSec builds the integration. You share your host's ISO 8583 specification and MineSec builds a dedicated integration to your host.
  • You implement the Outbound Host API. MineSec sends transactions in a standard format, and you add a protocol conversion layer on your side. See the Outbound Host API guide.

Manage merchants and terminals

Use the TMS Portal, or integrate with the TMS API to manage merchants, terminals and payment configuration from your own system.

Existing integrations that use the Access Gateway Management API keep working. TMS is replacing it, so use TMS for new integrations.