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

Create an order

POST
/merchants/{merchantId}/terminalOrders

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:

  • 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 in your Customer Area.

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.

Request Body

application/json

billingEntityId?string

The identification of the billing entity to use for the order.

When ordering products in Brazil, you do not need to include the billingEntityId in the request.

customerOrderReference?string

The merchant-defined purchase order reference.

items?array<>

The products included in the order.

orderType?string

Type of order

shippingLocationId?string

The identification of the shipping location to use for the order.

taxId?string

The tax number of the billing entity.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/merchants/string/terminalOrders" \  -H "Content-Type: application/json" \  -d '{    "customerOrderReference": "YOUR_REFERENCE",    "shippingLocationId": "S2-6A6C2E3432747D4F2F2C3455485E3836457D",    "billingEntityId": "MerchantAccount.YOUR_MERCHANT_ACCOUNT",    "items": [      {        "id": "PART-287001-EU",        "name": "Bluetooth Charging Base - V400m",        "quantity": 2      },      {        "id": "PART-620222-EU",        "name": "Receipt Roll",        "quantity": 20      }    ]  }'

Example response after creating an order for terminal products

{  "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    }  ]}

Get a list of orders GET

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](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).

Get an order GET

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](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).