Chapter 3 · Balance and withdrawals
Refunds and canceling a payment
API v3 has no refunds; only an unpaid payment can be canceled.
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 apayment.canceledevent 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.