# Cielo
source: https://developer.mastercard.com/mastercard-gateway/documentation/payment-methods/alt-pay-methods/payment-plans/cielo/index.md

Cielo is a payment plan which allows you to enter installment information on transactions that the Cielo acquire process. Merchants can only submit Cielo payment plan processing in Brazil for transactions in Brazilian reals currency and on cards issued in Brazil.

The number of payments and a minimum transaction amount of 5.00 BRL is required when selecting the Cielo plan type.

## Payment plan inquiry {#payment-plan-inquiry}

You can request the gateway for a list of valid plans for a transaction using the Payment Options Inquiry operation. The following details about the supported payment plans are returned:

* `paymentTypes.card.paymentPlans[n].numberOfDeferrals[n]`
* `paymentTypes.card.paymentPlans[n].numberOfPayments[n]`
* `paymentTypes.card.paymentPlans[n].payerInterest`
* `paymentTypes.card.paymentPlans[n].planId`

Warning: The plan identifier (`planId`) for Cielo is **CIELO**. Warning: From Gateway API version 70 and later, for the payment plan product Cielo, available payment plan offers are returned. Each payment plan offer has a unique offer ID.

* `paymentPlanProduct.{paymentPlanProductId}`
* `paymentPlanProduct.{paymentPlanProductId}.name`
* `paymentPlanProduct.{paymentPlanProductId}.logoUrl`
* `paymentTypes.card.paymentPlanOffer.{id}`
* `paymentTypes.card.paymentPlanOffer{id}.paymentPlanProductId`
* `paymentTypes.card.paymentPlanOffer.{id}.currency`
* `paymentTypes.card.paymentPlanOffer.{id}.numberofPayments`
* `paymentTypes.card.paymentPlanOffer.{id}.subsequentPaymentAmount`
* `paymentTypes.card.paymentPlanOffer.{id}.firstPaymentAmount`
* `paymentTypes.card.paymentPlanOffer.{id}.deferralPeriod`
* `paymentTypes.card.paymentPlanOffer.{id}.interest.charged`

**Payment Options Inquiry API Reference** [\[REST\]](https://developer.mastercard.com/mastercard-gateway/documentation/api-reference/v100/rest/api-ops/index.md#gateway) [\[NVP\]](https://developer.mastercard.com/mastercard-gateway/documentation/api-reference/v100/nvp/api-ops/index.md#gateway)

## Submit a transaction with the payment plan {#submit-a-transaction-with-the-payment-plan}

To submit a transaction with the payment plan selected by the payer, provide the following fields in an Authorize/Pay or Update Session request:

* `paymentPlan.numberOfDeferrals`
* `paymentPlan.numberOfPayments`
* `paymentPlan.planId`

Warning: From Gateway version 70 and later, provide the **paymentPlan.offerID** field with the offer ID in the Payment Options Inquiry response.

The gateway processes a payment plan only if the following conditions are met:

* The order currency is supported on the payment plan,
* The card type is supported on the payment plan.

**Payment Plans API Reference** [\[REST\]](https://developer.mastercard.com/mastercard-gateway/documentation/api-reference/v100/rest/api-ops/index.md#transaction) [\[NVP\]](https://developer.mastercard.com/mastercard-gateway/documentation/api-reference/v100/nvp/api-ops/index.md#transaction)
