Documentation contents
POST/transactions/{id}/refunds

Record a refund

Scope: refunds:write

Path parameters

idstringrequired
The resource identifier.
Format: uuid

Headers

Idempotency-Keystringrequired
The persisted UUID for this operation. Retry with the same UUID and original body.
Format: uuid

TRANSACTION_ID: the financial ID returned by Mereu in the authorized account.

Request body

external_refobjectrequired
Stable document references in your integration.
Fields external_ref
sourcestringrequired
The stable integration identifier authorized in the cabinet.
account_idstringrequired
The merchant identifier in the authorized binding.
location_idstringrequired
The authorized Mereu location UUID; inside external_ref, your own store identifier.
idstringrequired
The resource identifier.
refunded_totalobjectrequired
Actual cash refunded.
Fields refunded_total
amount_minorintegerrequired
An integer in minor units; 10000 means 100.00.
Format: int64
Range: 0 – 100000000
currencystringrequired
The operation currency code, such as MDL or EUR.
Values: "MDL" · "RON" · "EUR" · "USD" · "GBP" · "UAH" · "PLN" · "TRY" · "CHF" · "RUB" · "GEL" · "KZT"
refunded_eligible_amountobjectrequired
The original eligible goods value returned, before the benefit.
Fields refunded_eligible_amount
amount_minorintegerrequired
An integer in minor units; 10000 means 100.00.
Format: int64
Range: 0 – 100000000
currencystringrequired
The operation currency code, such as MDL or EUR.
Values: "MDL" · "RON" · "EUR" · "USD" · "GBP" · "UAH" · "PLN" · "TRY" · "CHF" · "RUB" · "GEL" · "KZT"
occurred_atstringrequired
Actual operation time with an offset.
Format: date-time
provider_refund_idstringrequired
The unique reference of the verified return.
reasonstringrequired
The verified reason, without personal data.
Response 200 · fields
dataobjectrequired
Authorized resource data.
Fields data
idstringrequired
The resource identifier.
Format: uuid
kindstringrequired
Values: "purchase" · "refund" · "reversal"
card_idstringrequired
The Mereu card UUID.
Format: uuid
location_idstringrequired
The authorized Mereu location UUID; inside external_ref, your own store identifier.
Format: uuid
program_version_idstringrequired
Format: uuid
external_refobjectrequired
Stable document references in your integration.
Fields external_ref
sourcestringrequired
The stable integration identifier authorized in the cabinet.
account_idstringrequired
The merchant identifier in the authorized binding.
location_idstringrequired
The authorized Mereu location UUID; inside external_ref, your own store identifier.
idstringrequired
The resource identifier.
original_transaction_idstring / nullrequired
Format: uuid
amountobjectrequired
Fields amount
amount_minorintegerrequired
An integer in minor units; 10000 means 100.00.
Format: int64
Range: 0 – 100000000
currencystringrequired
The operation currency code, such as MDL or EUR.
Values: "MDL" · "RON" · "EUR" · "USD" · "GBP" · "UAH" · "PLN" · "TRY" · "CHF" · "RUB" · "GEL" · "KZT"
eligible_amountobjectrequired
Eligible gross before the benefit for preview; eligible amount actually paid for purchases.
Fields eligible_amount
amount_minorintegerrequired
An integer in minor units; 10000 means 100.00.
Format: int64
Range: 0 – 100000000
currencystringrequired
The operation currency code, such as MDL or EUR.
Values: "MDL" · "RON" · "EUR" · "USD" · "GBP" · "UAH" · "PLN" · "TRY" · "CHF" · "RUB" · "GEL" · "KZT"
loyalty_deltastringrequired
statusstringrequired
The current resource or operation status.
Values: "applied" · "needs_review" · "rejected"
occurred_atstringrequired
Actual operation time with an offset.
Format: date-time
recorded_atstringrequired
Format: date-time
accrual_enabledboolean
review_reasonstring / null
compensationobject
Fields compensation
pointsstringrequired
A decimal string with at most two effective decimal places; additional places must be zero.
visitsintegerrequired
Range: 0 – …

Errors and retrying requests: recovery guide →