The shopping cart is where the information on the products chosen by the customer while browsing a store is gathered. This data may include item prices, shipping value, payment, and delivery methods, among others.

This guide will describe how to obtain information about the number of installments and their respective amounts from an existing payment method in the shopping cart.

Before starting the search for information about installments, make sure that there is already payment information (paymentData) assigned to the chosen cart (orderFormId).

The first step is to get the orderFormId of the shopping cart information that you want to obtain information about the amount of installments. For more information, access the Get cart information by ID guide.

With the orderFormId information available, you must use the Cart installments endpoint to send the following information through the URL:

• Path Param: orderFormId value.
• Query Param: paymentSystem. Payment method Id in which the installments information will be consulted.

See an URL example below:

https://{accountname}.{environment.com.br}/api/checkout/pub/orderForm/9420cbb7ebc34ca68a86621428816c5a?paymentSystem=2

After sending the request, the endpoint will return the response body containing the installments information, as shown in the example below:

️ For more information about the meaning of each of the fields available in the shopping cart, access the orderForm overview.

The following errors may appear as a message in the response body.

• Message error example (code ORD002): "Invalid order form". The orderFormId information is not valid.

• Message error example (code CHK0152): "Orderform does not have installment options". This shopping cart does not have any payment information (paymentData).

• Message error example: "The requested URL was not found on the server". Check that the URL data is correct.