Last update 20/04/2016

1. What is Cielo Installments?

Cielo is a Brazilian acquirer that allows you to accept VISA and MasterCard payments. With Installments (a popular means of payment in Brazil) you enable your customers to pay with VISA/MasterCard in several installments.

On the Ingenico ePayments platform, Cielo Installments must be integrated in the DirectLink (server-to-server) mode.

2. Requirements and important notes

To accept Cielo Installments, you need to make sure that:

  • Your contract with Cielo supports Installments
  • DirectLink is activated in your Ingenico ePayments account
Important
  • Dates of installments: Ingenico ePayments does not control when the installments take place. This is a contractual aspect to be checked with Cielo directly. However, usually the payment happens 30-31 days after the sale, on business days only.
  • Amount of installments: Ingenico ePayments does not control the amount of each installment. The installments are automatically calculated by Cielo, as per contractually agreed with Cielo. 
  • Minimum amount for installments: Each installment MUST have a minimum amount of 5.00 BRL (meaning that a transaction with 2 installments must have a minimum value of 10.00 BRL; 3 installments must have a minimum value of 15.00 BRL etc.). If not, the transaction gets automatically rejected by the issuing bank.
  • Pay date: The date when you receive the money is as per contractually agreed with Cielo, and thus needs to be checked with Cielo directly.

3. Configuration

No additional configuration is required.

4. Integration with DirectLink

Cielo Installments must be integrated with Ingenico ePayments DirectLink (cf. DirectLink integration guide).

In your order request, the following additional fields must be sent:

Field Description Format
CREDITCODE (*)
Product code: Accepted values:
1- Credit
2- Merchant Installment Plan
3- Issuer Installment Plan
A- Debit
AN, 1
PAYMENTOCCURRENCE
Number of installments, min. 2 max. 24.
For credit or debit, use “1”.
N, 2

(* If uncertain, please check with Cielo directly which credit code(s) you can use. Cielo has to enable this in your account with them.)

5. Testing

You can use the following details to test Cielo Installments in your Ingenico ePayments test account:

Payment method
UID TID Card number
VISA 1006993069
11111
41111111111111111
MasterCard 1006993069
11111
5399999999999999

6. Reporting

You can have the PAYMENTOCCURRENCE and CREDITCODE information returned to you in your reports.

If you log on to your Ingenico ePayments account, go to "Operations" > "Electronic reporting" (optionally first click "File format") and under the "Dynamic" structure select the fields from the "Available fields" drop-down menu.

This website uses cookies to be able to give you the best user experience. If you don't want to accept these cookies, we allow you to change the cookie settings. Click 'Accept' to allow all cookies from this website.

Cookie settings

Introduction

Functional

Functional cookies are required for the website to operate correctly. These cookies cannot be disabled.

Optimized

Optimization cookies allow us to analyze site usage so we can measure and improve our website.
This is the default level.

Personalized

Personalization cookies are used for social media and advanced personalization. They allow us to show you information related to your company.


Example functionality allowed

  • Store country preference
  • Store language preference

Example functionality not allowed

  • Saving personal data
  • Anonymous tracking via Google Analytics
  • Tracking for remarketing purposes

Example functionality allowed

  • Store country preference
  • Store language preference
  • Anonymous tracking via Google Analytics

Example functionality not allowed

  • Saving personal data
  • Tracking for remarketing purposes

Example functionality allowed

  • Store country preference
  • Store language preference
  • Anonymous tracking via Google Analytics
  • Serve content relevant to your interests
  • Serve ads relevant to your interests
  • Tracking for remarketing purposes

Example functionality not allowed

  • Saving personal data