Refunds a Single Transaction or Frequent Transaction

Each method has a specific time window during which a refund can be issued. Once this period expires, refunds can no longer be processed via the API for that payment.

Refund Deadlines by Payment Method

Payment Method	Maximum Refund Time
MB WAY	12 months
Visa & Mastercard	12 months
Apple Pay	12 months
Google Pay	12 months
Samsung Pay	12 months
MB SPG references	120 days
Other MB references	No limit
Direct Debit	180 days

Required scope: <code style="background:#e8f0fe;color:#1a73e8;padding:2px 8px;border-radius:12px;font-size:0.85em">refund:create</code>

idstring uuid required

The capture uuid associated with Single or Frequent Transaction

Request body

transaction_keystring

Your internal key identifying this refund

ibanstring

Optional - Iban from the bank account

emailstring

Optional - Email from the bank account holder

phonestring

Optional - Phone from the bank account holder

account_holderstring

Optional - Bank account holder name

valuenumber double required

The amount to refund. When revert is present, this is the gross amount from the payer's perspective — the amount refunded to the payment method plus any redeemed reward credits being restored.

Example request

{
  "value": 17.5,
  "revert": {
    "reward_redemption_reversal": 2.5
  }
}

Response

Created

statusstring

messagestring

idstring uuid

A unique identifier for the resource. While typically formatted as a UUID (Universally Unique Identifier), it can also be in other formats as defined by the user. This field ensures the resource can be distinctly recognized and referenced.

Example response

{
  "status": "ok",
  "message": "Your request was successfully created",
  "id": "25997c28-1902-4f6d-842e-c6050e7d5421"
}

v1