Skip to content

Chapter 3 · Balance and withdrawals

Refunds and canceling a payment

API v3 has no refunds; only an unpaid payment can be canceled.

1 min read

On this page
  1. API v3 has no refunds
  2. What can be canceled
  3. Legacy API (v1/v2)

API v3 has no refunds

MirPay API v3 does not support refunds. A successful (succeeded) payment cannot be reversed through the API or the dashboard — succeeded is a final status.

If you have a question about a specific payment, contact the Help Center and include the payment ID.

What can be canceled

Only a payment that hasn't been paid yet — status pending — can be canceled:

  • You — via the API: POST /api/v3/payments/{id}/cancel. The checkout page stops working and a payment.canceled event is sent.
  • The customer — on the checkout page itself.

If the payment is not pending, the cancel request returns 400 payment_not_cancelable.

An unpaid payment automatically becomes expired when its lifetime runs out (at most 15 minutes in live mode).

Legacy API (v1/v2)

v1 and v2 integrations and their callbacks keep working unchanged — you don't need to change your existing integration.

Was this article helpful?

Didn’t find an answer?

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