POST
/purchasesRecord an already-paid sale
Scope: purchases:write
Headers
Idempotency-Keystringrequired- The persisted UUID for this operation. Retry with the same UUID and original body.
- Format: uuid
Request body
location_idstringrequired- The authorized Mereu location UUID; inside external_ref, your own store identifier.
- Format: uuid
card_idstringrequired- The Mereu card UUID.
- 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.
paid_totalobjectrequired- Actual money paid; for commit, it must equal expected_paid_total from the quote.
Fields paid_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"
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"
paid_atstringrequired- Actual payment time, RFC3339 with an offset.
- Format: date-time
provider_payment_idstringrequired- The unique, verified payment reference in your system.
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
amountobjectrequiredFields 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_deltastringrequiredstatusstringrequired- 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_enabledbooleanreview_reasonstring / nullcompensationobjectFields 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 →