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:

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.

Servers

Path parameters

Name Type Required Description
merchantId String Yes

The unique identifier of the merchant account.

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
orderType String No

Type of order

shippingLocationId String No

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

customerOrderReference String No

The merchant-defined purchase order reference.

items[] Array No

The products included in the order.

items[].id String No

The unique identifier of the product.

items[].installments Integer No

The number of installments for the specified product id.

items[].name String No

The name of the product.

items[].quantity Integer No

The number of items with the specified product id included in the order.

taxId String No

The tax number of the billing entity.

billingEntityId String No

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.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.