Get a list of orders
Returns a list of terminal products orders for the merchant account 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.
In: header
Path Parameters
Query Parameters
Your purchase order number.
The order status. Possible values (not case-sensitive): Placed, Confirmed, Cancelled, Shipped, Delivered.
The number of orders to skip.
int32The number of orders to return.
int32Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/merchants/string/terminalOrders"Example response with the terminal orders for a merchant account
{ "data": [ { "id": "4154567890100682", "customerOrderReference": "YOUR_REFERENCE_M2", "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 } ] }, { "id": "8315943674501996", "customerOrderReference": "YOUR_REFERENCE_M1", "status": "Cancelled", "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-04T09:41:07.000Z", "items": [ { "id": "TBOX-V400m-774-EU", "name": "V400m Package", "quantity": 1 } ] } ]}Get a list of terminal models GET
Returns the payment terminal models that the merchant account identified in the path has access to. The response includes the terminal model ID, which can be used as a query parameter when getting a list of terminals or a list of products for ordering. To make this request, your API credential must have one of the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions): * 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](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment).
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).