Sign in

v1

latestOpenAPI 3.0.12026-07-242871595.3 MB
ORDERS

Update an order

Updates a single order. See working-with-orders for more details.

post/v3/merchants/{mId}/orders/{orderId}

Path parameters

mIdstring required

Merchant identifier.

orderIdstring required

Order identifier.

Query parameters

expandstring

Additional information provided as an expanded response: [lineItems, serviceCharge, discounts, credits, payments, customers, orderFulfillmentEvent, refunds]

Headers

User-Agentstring required

Identifies the application, operating system, vendor, and/or version of the requesting user agent. Format: <AppName>/<Version> <Comment>

Request body

idstring

Universally Unique Identifier (UUID) of the order.

currencystring

Three-letter ISO 4217 currency code. Format: Lower case Length: Maximum 3

totalinteger

Total price of the order in cents

externalReferenceIdstring

External reference id if present in the order

unpaidBalanceinteger

The net of orders with payment minus the amount collected. Includes refunds, manual refunds, tax, tip, service charge, non-revenue items, paid gift card activations and loads and discounts

paymentState'OPEN' | 'PAID' | 'REFUNDED' | 'CREDITED' | 'PARTIALLY_PAID' | 'PARTIALLY_REFUNDED'

Is this order paid or not?

titlestring
notestring

An arbitrary string with information about this order, may be printed on the order receipt and displayed in apps

taxRemovedboolean

If true then this order should not have taxes applied to it

isVatboolean

This order was created by merchant with VAT enabled.

statestring

Order state. Values: . open or OPEN and locked - Automatically set by Clover, for example: when a line item is added to the order or a payment is taken. . When an order is created using REST API, Clover recommends manually setting the order state value to Open. . When an order is created using Android SDK, do not manually set the order state. The value must be left empty, and Clover automatically updates the value to open and locked. . Null - Default value when no value is manually set. This indicates a hidden order. Hidden orders do not display on the screen but can be retrieved using order ID.

manualTransactionboolean

Whether this order represents a manual transaction. A manual transaction is a transaction that has an arbitrary amount defined and is not associated with any inventory items. For example, the Clover Sale App and Clover Manual Transaction App create manual transactions. A manual transactions will have a single associated line item to hold the sale amount, but the generated receipt will display this differently to indicate that it is not considered a typical order with inventory items.

groupLineItemsboolean

Whether similar line items should be grouped together on the receipt that this order generates. Item "similarity" is based on items having matching values for a set of properties including price, modifiers, and discounts.

testModeboolean

Whether this order was created in test mode. Payments made against test orders are not processed. Test mode orders can be deleted from the Orders App on the merchant's device or web dashboard (https://www.clover.com/orders/m/{mId}/orders). They will also be deleted when the device sends a POST to the /v2/merchant/{mId}/orders/delete_all_tests endpoint.

payType'SPLIT_GUEST' | 'SPLIT_ITEM' | 'SPLIT_CUSTOM' | 'FULL'

Possible values: SPLIT_GUEST, SPLIT_ITEM, SPLIT_CUSTOM, FULL. During the payment flow, if the user chooses to split the payment for this order, this field will be set to one of the SPLIT_* values to indicate how the full amount should be split. If the user chooses to pay for the order in full with one payment, then this field will be FULL.

createdTimeinteger

Creation timestamp

clientCreatedTimeinteger

Time at which the client created this order.

modifiedTimeinteger

Last modified time of the order.

deletedTimestampinteger