POST
/checkoutsReserve a benefit
Scope: checkouts:write
Headers
Idempotency-Keystringrequired- The persisted UUID for this operation. Retry with the same UUID and original body.
- Format: uuid
Request body
quote_idstringrequired- The quote ID returned by preview.
- 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.
Response 200 · fields
dataobjectrequired- Authorized resource data.
Fields data
idstringrequired- The resource identifier.
- Format: uuid
statusstringrequired- The current resource or operation status.
- Values: "prepared" · "payment_started" · "committed" · "cancelled" · "expired" · "needs_review"
quote_idstringrequired- The quote ID returned by preview.
- Format: uuid
card_idstringrequired- The Mereu card UUID.
- Format: uuid
location_idstringrequired- The authorized Mereu location UUID; inside external_ref, your own store identifier.
- 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.
reserved_untilstringrequired- Format: date-time
transaction_idstring / nullrequired- The financial ID for transaction reads and refunds.
- Format: uuid
revisionintegerrequired- The current checkout revision.
- Format: int64
- Range: 1 – …
updated_atstringrequired- Format: date-time
review_reasonstring / null
Errors and retrying requests: recovery guide →