Cielo - Cards

This page presents all information related to the Cielo connection using Cards as payment. Use the following buttons to navigate to the desired section.

Connecting with Yuno

Mandatory fields when integrating via Yuno:

No mandatory fields are required. However, the provider may request additional fields according to the merchant or to improve the approval rate.

General information

Countries:

brazil-flag
Brazil

Currencies:

BRL.

Payment methods:

Credit card
Credit card
debit card
Debit card
Prepaid card
Prepaid card
Apple Pay
Apple Pay
Google Pay
Google Pay

Support of international BIN:

Yes

Activation of functionality:

Yes, merchant level.

TRX without CVV:

Yes, it needs to be activated.

Purchase TRX in 1-Step:

Yes

Purchase TRX in 2-Step:

Yes

Support for recurrency:

Yes

Type of integration:

B2B

Captures

Partial capture:

No

Multiple captures:

No

Maximum time to capture an authorization:

7 days.

Captures over the amount of authorization:

No

Refunds

Refund support:

Yes

Partial refunds:

Yes

Multiple refunds:

No

Time to request refund:

180 days.

Voids

Void support:

Yes

Void to authorization:

Yes

Void to refund:

No

Installments

Capability to define the installments when creating the payment:

Yes

GET endpoint available for retrieving the permitted BIN for the installments:

No

Possibility to choose who will be responsible for financing installments:

No

Deferral date availability:

No

Grace period:

No

Minimum number of Installments (#months):

Each installment MUST have a minimum number 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

Maximum number of Installments (#months):

Depends on the BIN.

Chargebacks

Notifications of chargebacks:

Yes

Security

3DS v2:

Yes

Testing guidelines for sandbox environment

Necessary fields for testing:

Merchant ID
Merchant Key

Test cards:

FINAL CARD DIGIT TRANSACTION STATUS RETURN CODE RETURN MESSAGE
XXXX.XXXX.XXXX.XXX0 Authorized 4/6 Operation performed successfully
XXXX.XXXX.XXXX.XXX1 Authorized 4/6 Operation performed successfully
XXXX.XXXX.XXXX.XXX4 Authorized 4/6 Operation performed successfully
XXXX.XXXX.XXXX.XXX2 Not Authorized 05 Not Authorized
XXXX.XXXX.XXXX.XXX3 Not Authorized 57 Expired Card
XXXX.XXXX.XXXX.XXX5 Not Authorized 78 Locked Card
XXXX.XXXX.XXXX.XXX6 Not Authorized 99 Time Out
XXXX.XXXX.XXXX.XXX7 Not Authorized 77 Canceled Card
XXXX.XXXX.XXXX.XXX8 Not Authorized 70 Problems with the Credit Card
XXXX.XXXX.XXXX.XXX9 Random Authorization 4 - 99 Operation Successful / Time Out

Integration configuration

Credentials and steps to obtain them:

Email your Cielo TAM. Ask for your credentials.

Dashboard configuration:

  1. Log in to dashboard.y.uno.
  2. Click Connections and then select Cielo.
  3. Click Connect.
  4. Introduce Name, Merchant ID and Merchant Key.
  5. Click Connect