APIMatic Adyen APIs
Sign Up to APIMatic
HomeSDKsAPI ReferenceContext Plugin
ManagementTerminal ordersTerminal orders merchant level

Get an order

GET
/merchants/{merchantId}/terminalOrders/{orderId}

Returns the details of the terminal products order identified in the path.

To make this request, your API credential must have one of the following roles:

  • Management API—Terminal ordering read
  • Management API—Terminal ordering read and write

In the live environment, requests to this endpoint are subject to rate limits.

Authorization

AuthorizationBasic <token>

In: header

Path Parameters

merchantId*string

The unique identifier of the merchant account.

orderId*string

The unique identifier of the order.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/merchants/string/terminalOrders/string"

Example response with the details of the terminal products order

{  "id": "4154567890100682",  "customerOrderReference": "YOUR_REFERENCE",  "status": "Placed",  "shippingLocation": {    "id": "S2-6A6C2E3432747D4F2F2C3455485E3836457D",    "name": "YOUR_COMPANY Spain",    "contact": {      "firstName": "Pablo",      "lastName": "Mengano",      "phoneNumber": "+34911234567",      "email": "Pablo.Mengano@company.com"    },    "address": {      "streetAddress": "Paseo de la Castellana 43",      "streetAddress2": "7 piso",      "postalCode": "28046",      "city": "Madrid",      "country": "ES"    }  },  "billingEntity": {    "id": "MerchantAccount.YOUR_MERCHANT_ACCOUNT",    "name": "YOUR_MERCHANT_ACCOUNT",    "taxId": "ES1234567890",    "email": "Pablo.Mengano@company.com",    "address": {      "streetAddress": "Paseo de la Castellana 43, 7",      "postalCode": "28046",      "city": "Madrid",      "country": "ES"    }  },  "orderDate": "2022-01-21T16:12:33Z",  "items": [    {      "id": "PART-287001-EU",      "name": "Bluetooth Charging Base - V400m",      "quantity": 2    },    {      "id": "PART-620222-EU",      "name": "Receipt Roll",      "quantity": 20    }  ]}

Create an order POST

Creates an order for payment terminal products for the merchant account identified in the path. To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Terminal ordering read and write >Requests to the Management API test endpoint do not create actual orders for test terminals. To order test terminals, you need to [submit a sales order](https://docs.adyen.com/point-of-sale/managing-terminals/order-terminals/#sales-order-steps) in your Customer Area. In the live environment, requests to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment).

Update an order PATCH

Updates the terminal products order identified in the path. Updating is only possible while the order has the status **Placed**. The request body only needs to contain what you want to change. However, to update the products in the `items` array, you must provide the entire array. For example, if the array has three items: To remove one item, the array must include the remaining two items. Or to add one item, the array must include all four items. To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * Management API—Terminal ordering read and write In the live environment, requests to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment).