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].payerInterest
paymentTypes.card.paymentPlans[n].planId
planId
) for Cielo is CIELO
.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][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.