Commerce Checkout - Model

Glossary

ATTRIBUTEDESCRIPTIONType
basketobject
basket.idThe identifier of the basket being checked out, returned from Create Basketstring
orderobject
order.channelOrderIdYour channel's unique ID for this order. Deliverect uses it to reference the order in webhooks and reporting, so it must not be reused. If not supplied, it will be auto-generated.string
order.channelOrderDisplayIdThe short reference displayed on the POS, kitchen tickets, and receipts. Keep it concise and human-readable.string
order.byThe ordering surface or client that placed the order (e.g. "Mobile App", "Web App", "Kiosk"). Useful for reporting and support.string
order.courierControls delivery handling. Set "restaurant" to initiate integrated Deliverect Dispatch flows; any other string (e.g. "thirdparty") indicates a third-party courier not managed via Deliverect.string
order.validationIdUUID returned by the Dispatch Availability endpoint which helps to secure a courier and pre-validated delivery job quotestring
order.includeCutleryConfirm to store if cutlery is requested with the orderboolean
noteA free-text, order-level note passed through at checkout (e.g. delivery or preparation instructions).string
paymentsArray of one or more payment entries. The sum of all amount values must equal the basket total.array
payments[].typePayment types: dpay |gift_card |third_partyenum
payments[].externalIdReference for the payment: if Deliverect Pay it would be the paymentId, for gift_card it'd be the transaction ID.string
payments[].isPrepaidWhether the amount has already been collected. false means the amount is still due (e.g. cash on delivery).boolean
payments[].amountThe total amount paid should be sent as an integer with 2 decimal digits, for example, 1 dollar would be sent as 100.integer
payments[].instrumentTypeFor third_party payments only: the underlying instrument, e.g. cash, card, online.string
payments[].metadataAdditional data, required for gift_card payments.object
payments[].metadata.giftCardProviderProfileLinkIdFor gift_card payments only: the identifier linking the gift card provider's profile/integration configuration used to process the payment.string
payments[].metadata.giftCardNumberFor gift_card payments only: the card number of the gift card being redeemed.string
payments[].metadata.giftCardVerificationCodeFor gift_card payments only: the verification/security code of the gift card being redeemed.string