Documentation

Build on miaPOS rails.

Docs, SDKs, sandbox — everything to ship.

miaPOS is an instant-payment acceptance platform. Eight paypoints, one API, scheme-agnostic rails. These docs are split into two tracks — pick the one that fits.

Track 01

User Guide

Use miaPOS as a merchant or end user — terminals, phones, links, chat, AI agents. No code needed.

Six products ↓

Track 02

API & Integration

Embed miaPOS in your product. REST API, plugins for popular shops, SDKs, sandbox, signed webhooks.

Get started ↓

Track 01 · User Guide

How to use each product.

Every product we ship, and the documentation that exists for it — how the merchant works it, and how a developer wires it in. A dash means that kind of guide does not exist yet.

Product

For users

For developers

Hardware POS

In-store countertop terminal — Sunmi, SmartOne, Datecs, Ingenico, PAX.

The seller's guide

The whole counter routine: opening the day, QR codes, tips, refunds, the Z report, what to do when something breaks. 11 chapters.

Also in RO · RU

See also: using the terminal · activating it on Sunmi or SmartOne

Integration guide

Countertop terminal — Sunmi V2/P2 and SmartOne — running the miaPOS native Android app.

Also: Android Intent

Windows CLI for cash registers

One command from the till software — MIA and a card CLI in parallel.

—

Integration guide

miaposCLI.exe — invoked from any cash-register software, no UI of its own.

SoftPOS

Phone or tablet as a payment terminal.

Setting up your phone

Turn your phone or tablet into a payment terminal.

Integration guide

Turn any phone or tablet into a terminal.

E-commerce checkout

Accept on your web shop.

Adding miaPOS to your shop

Add miaPOS to your online store — pick a plugin or have your developer wire the API.

Integration guide

Integrate miaPOS as an instant-payment checkout in your online store.

Plugins: WooCommerce · OpenCart · CS-Cart · PHP SDK

Embed checkout

Inline JS snippet on your own page or inside a Telegram Mini App.

—

Integration guide

Three-line embed — script + div + miaPOS.mount(). Same backend as hosted; additive, no protocol fork.

Payment Links & RtP

Tokenized URLs or push-to-bank requests.

Sending links and requests

Send a payment link by DM, email, invoice, sticker or Instagram bio.

Integration guide

Payment Links — reusable tokenized URLs for invoices and social commerce.

Checkout in chat — public bot @miaposbot.

Selling in Telegram

Accept payments right inside Telegram with @miaposbot — no apps, no new devices, no leaving the conversation with your customer.

Also in RO · RU · FR · DE

Integration guide

Telegram checkout in the same chat where the conversation happens.

WhatsApp Business bot at +373 690 02 773 — sibling channel of Telegram, same broker.

Selling in WhatsApp

Ask the bot for a link, forward it to the customer, get told in the same chat when the money lands. Setup, commands, the 24-hour rule.

Also in RO · RU

Integration guide

Onboarding, command grammar, architecture, security model, roadmap.

Agentic

Accept payments from AI agents.

Enabling agent payments

Let AI agents (Claude, ChatGPT, custom) pay you on behalf of their users.

AIPS integration

AIPS — open acquiring protocol that lets AI agents pay merchants.

MIA Merchant Portal

The merchant's web back office — and where payment links and requests are sent from.

The user guide

Sign-in without a password, dashboard, transactions and refunds, links and requests, disputes, reports, stores, terminals, sellers, users. 9 chapters.

Also in RO · RU

—

Track 01 · Downloads

Take it off the screen.

Both full guides as PDF — print one for the counter, forward another to a new hire on their first day.

Counter · Terminal app

miaPOS app — seller's guide

49 pages with screenshots. Activation, the working day, QR codes and their amount modes, tips, links and requests, refunds, receipts, the X and Z reports, and the counter card to pin next to the terminal.

PDF · EN PDF · RO PDF · RU

Back office · Web

MIA Merchant Portal — user guide

52 pages with screenshots. Sign-in without a password, the four roles, dashboard, transactions and refunds, links and payment requests, disputes with the bank, reports, and the administration of stores, terminals, sellers and users.

PDF · EN PDF · RO PDF · RU

Track 02 · API & Integration

For developers.

Start with the basics, pick a plugin or integrate the API, ship to sandbox before you ship to production.

Get started

Set up, authenticate, send your first payment.

Overview

miaPOS is an instant-payment acceptance platform. Eight paypoints, one API, scheme-agnostic rails.

Quickstart

From zero to a verified payment in ten minutes. Sandbox-only, no production access required.

Sandbox & environments

How sandbox differs from production, how to get access, and how to flip the switch when you ship.

Authentication

OAuth2-style access tokens with refresh. Long-lived secret key never crosses the wire after the first issuance.

Plugins & SDKs

Drop-in integrations for popular e-commerce platforms.

WooCommerce

Drop-in WooCommerce gateway for miaPOS instant payments. Install, configure credentials, accept.

OpenCart

Drop-in OpenCart gateway for miaPOS instant payments. Install, configure credentials, accept.

CS-Cart

Drop-in CS-Cart gateway for miaPOS instant payments. Install, configure credentials, accept.

PHP SDK

Composer-installable PHP SDK that wraps the E-comm API. Twenty lines from include to first payment.

Custom integration

When no plugin fits — integrate the E-comm API directly. This page is the orientation map.

API reference

REST endpoints, request and response schemas, error catalog.

E-comm API

Full reference for the miaPOS E-comm API. Endpoints, schemas, examples, error codes.

POS API

Full reference for the miaPOS POS API. Endpoints, schemas, examples, error codes.

External Integration API

Full reference for the miaPOS External Integration API. Endpoints, schemas, examples, error codes.

Webhooks

How miaPOS notifies your backend when a payment changes state. Signed, idempotent, retried with backoff.

Signature verification

Verifying signed callbacks from miaPOS. RSA-SHA256, public key fetched once, cached, rotated on key change.

Rails & protocols

How miaPOS connects to instant-payment networks.

AIPS protocol

AIPS — Agentic Instant Payment Scheme. Open acquiring protocol for AI-driven commerce. Acquiring-only, scheme-agnostic.

ISO 20022

How miaPOS speaks ISO 20022 to bank backends. Dual-signal inbound (pacs.008 + pacs.002), structural envelope, JSON projection of XML.

Who integrates miaPOS

Three partner shapes, one platform.

ISVs & platforms

Embed miaPOS as one acceptance option for your end-merchants. Multi-tenant model, revenue share, programmatic onboarding via the External Integration API.