miaPOS.eu
Contact sales
Docs · Get started

Quickstart

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

AudienceDeveloper
DifficultyBasic
Updated2026-05-30

Overview

The fastest path to a working integration: register the payment, redirect the customer, verify the result. Three calls, sandbox keys, no signed contract needed to try it.

1. Get sandbox credentials

Email [email protected] with your company name and one technical contact. You'll get back:

  • merchantId, terminalId, secretKey — for token issuance
  • ecommBaseUrl: https://ecomm-test.miapos.md
  • The miaPOS public key for verifying callbacks

2. Get an access token

POST/ecomm/api/v1/token
curl -X POST https://ecomm-test.miapos.md/ecomm/api/v1/token \
  -H "Content-Type: application/json" \
  -d '{"merchantId":"M12345","secretKey":"...","terminalId":"T0001"}'

Response: { "accessToken": "...", "refreshToken": "..." }

3. Register a payment

POST/ecomm/api/v1/pay
{
  "orderId": "TEST-001",
  "amount": 1.00,
  "currency": "MDL",
  "payDescription": "Sandbox test",
  "successUrl": "https://example.com/ok",
  "failUrl":    "https://example.com/no",
  "callbackUrl":"https://example.com/cb"
}

Response includes paymentId and checkoutPage. Open the checkoutPage in a browser to simulate the customer flow.

4. Verify the result

GET/ecomm/api/v1/payment/{paymentId}

Returns the final status. In sandbox you can also wait for the callback to callbackUrl — see Webhooks for the payload shape.

That's it
Three calls, one paid order. The rest of the docs go deeper into specific paypoints, plugins, and the API surface.

Where to next