Commerce Checkout - Glossary

Glossary

TERMDESCRIPTIONType
basket.idThe identifier of the basket being checked out, returned from Create Basketstring
channelOrderIdThe unique reference for the order on the commerce channel (if not supplied, will be auto-generated)string
channelOrderDisplayIdA shorter, human-readable order reference shown to staff and customers (e.g. on receipts and POS screens).string
byTo identify the origin of the order, e.g. "Mobile App", "Web App", "Kiosk".string
courierIndicates who is responsible for delivery fulfillment. To initiate Deliverect integrated Dispatch flows, specify "restaurant" any other string indicates a third-party courier not managed via Deliverect will be used.string
validationIdUUID returned by the Dispatch Availability endpoint which helps to secure a courier and pre-validated delivery job quotestring
paymentsArray of one or more payment entries. The sum of all amount values must equal the basket total.Array
typePayment types: dpay |gift_card |third_partyenum
externalIdReference for the payment: if Deliverect Pay it would be the paymentId, for gift_card it'd be the transaction ID.string
isPrepaidWhether the amount has already been collected. false means the amount is still due (e.g. cash on delivery).boolean
amountThe total amount paid should be sent as an integer with 2 decimal digits, for example, 1 dollar would be sent as 100.integer
instrumentTypeFor third_party payments only: the underlying instrument, e.g. cash, card, online.string
metadataAdditional data, required for gift_card paymentsarray