Skip to content

Chapter 1 · Getting started

How to connect to MirPay as a merchant

Sign up, verify your identity, open a virtual cashbox and get an API key — step by step.

2 min read

On this page
  1. 1. Sign up
  2. 2. Verify your identity
  3. 3. Open a virtual cashbox
  4. 4. Get your API keys

To accept payments with MirPay you go through four steps: create an account, verify your identity, open a virtual cashbox, and connect your integration once the cashbox is approved.

1. Sign up

  1. On mirpay.uz, click Sign up.
  2. Enter your name, email and a password (at least 8 characters).
  3. Confirm your email using the link we send you. Dashboard sections stay locked until your email is verified.

2. Verify your identity

Your identity must be verified before you can open a cashbox.

  1. In the dashboard, open Documents and click Identity verification.
  2. Accept the user agreement and click Start identity verification.
  3. You are taken to the secure GOXOST KYC page — follow the instructions there. It is easiest on a phone.

The result usually arrives within a few minutes. Some applications are reviewed manually, which can take up to 3 days. The result appears in Documents.

Status Meaning
Approved Your identity is verified. Your Agreement and Certificate appear here.
Under review Your application is being reviewed — please wait.
Awaiting verification The process isn't finished. Click Continue.
Rejected If a Try again button is shown, try once more. Otherwise contact the Help Center.

3. Open a virtual cashbox

  1. Go to Virtual cashbox and click New cashbox.
  2. Fill in the form:
    • About the store — store name, name shown on the checkout page, project type (Website or Telegram bot), website address or bot token, slogan, short description, business type and category, start date, working hours.
    • Contact — support phone and email, Telegram (Instagram is optional).
    • Integration — Success URL, Cancel URL, Webhook URL, per-transaction limit and daily limit (in sum, at least 1,000), optional IP allowlist.
    • Withdrawal details — card or bank account.
    • Files — logo (required), banner and an extra document (optional).
  3. Accept the terms and click Submit application.

The cashbox is reviewed by our team. While under review its status is Under review; once approved it becomes Active.

4. Get your API keys

  1. Open Developers and select your cashbox.
  2. On the API keys page, click Create key.
  3. Copy the key right away and store it safely — it is shown only once.

A test key (sk_test_…) works even before your cashbox is approved, so you can try the integration without real money. A live key (sk_live_…) accepts real payments only after the cashbox is approved. See the article "API keys and test mode" for details.

For the legacy v1/v2 integration, the cashbox ID, API key and callback secret are under Virtual cashbox → Details, in the Keys block.

Was this article helpful?

Didn’t find an answer?

Send a request — a specialist will check your account and reply.