Cielo
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
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].payerInterestpaymentTypes.card.paymentPlans[n].planId
planId) for Cielo is CIELO.paymentPlanProduct.{paymentPlanProductId}paymentPlanProduct.{paymentPlanProductId}.namepaymentPlanProduct.{paymentPlanProductId}.logoUrlpaymentTypes.card.paymentPlanOffer.{id}paymentTypes.card.paymentPlanOffer{id}.paymentPlanProductIdpaymentTypes.card.paymentPlanOffer.{id}.currencypaymentTypes.card.paymentPlanOffer.{id}.numberofPaymentspaymentTypes.card.paymentPlanOffer.{id}.subsequentPaymentAmountpaymentTypes.card.paymentPlanOffer.{id}.firstPaymentAmountpaymentTypes.card.paymentPlanOffer.{id}.deferralPeriodpaymentTypes.card.paymentPlanOffer.{id}.interest.charged
Payment Options Inquiry API Reference [REST][NVP]
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
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.