Cielo | DEUNA Docs

En esta página

Integrar Cielo
Consideraciones especiales y limitaciones
Recursos de prueba

Esta página proporciona una guía para integrar Cielo con DEUNA.

Operaciones soportadas

La integración de Cielo en tu estrategia de pagos con DEUNA te permite realizar las siguientes operaciones:

Autorización
captura completa
Capturas parciales
Compra (captura automática)
Reembolso parcial (hasta uno por pedido)
Reembolso completo
Anulación
3DS DEUNA

Métodos de pago admitidos

Tarjetas

visa
Mastercard
Comensales
Amex
elo

Países y monedas activos

Brasil (BRL)

Requisitos

Contacta a tu representante Cielo y solicita las siguientes credenciales:

Tus credenciales de Cielo

Integrar Cielo#

Integrar Cielo en DEUNA.

1. Busca Cielo en DEUNA

Busque Cielo en Conexiones y haga clic en él.

2. Configura Cielo en tu tienda

Después de buscar Cielo en Connections, debes configurar Cielo en tu tienda.

En Conexiones se abrirá una ventana como la siguiente:

Ingrese las siguientes credenciales:
- En Nombre introduzca un nombre para hacer referencia a la credencial.
- En Moneda seleccione la moneda del procesador comercial disponible.
- En Externo Merchant ID ingrese la identificación del comerciante externo de Cielo.
- En Private API Key ingrese la clave privada de Cielo.
Elija el tipo de operación que desea realizar:
- Compra
- Autorización
Elige si quieres activar 3DS.
Clic Conectar.

Una vez que complete los pasos, verá un mensaje de éxito.

3. Procesar pagos con Cielo

Verás la conexión de Cielo dentro de la pestaña Conexiones activas.

A partir de este momento ya podrás procesar transacciones con Cielo a través de DEUNA.

Ejemplo de compra v2

JSON

{
    "payer_info": {
        "email": "omar_guzhnay@gmail.com"
    },
    "order_type": "DEUNA_NOW",
    "payment_source": {
        "method_type": "credit_card",
        "card_info": {
            "expiry_month": "12",
            "expiry_year": "2026",
            "card_holder_dni": "12345678000195",
            "card_holder": "Omar Guzhnay",
            "card_number": "4024007197692931",
            "card_cvv": "123",
            "address1": "Rua Visconde de Pirajá, 123, apto 12",
            "address2": "apto 12",
            "zip": "22410001",
            "city": "MIGUEL HIDALGO",
            "state": "CIUDAD DE MÉXICO",
            "country": "BR",
            "phone": "+5511985176644",
            "installments": 1
        }
    },
    "order": {
        "order_id": "a7c1d6c6-9a36-49b1-8cee-dd5434f3d270",
        "currency": "BRL",
        "statement_descriptor":"test",
        "market_type": "ecommerce",
        "items": [
            {
                "id": "00ab2d23-f44a-4782-aa7c-bb4fadeddfe3",
                "name": "Item #1",
                "description": "Description Item #1",
                "total_amount": {
                    "original_amount": 115000,
                    "amount": 115000,
                    "total_discount": 0,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "quantity": 1,
                "image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
                "taxable": true
            },
            {
                "id": "3cb41aec-1be8-4255-a386-94bb316a8157",
                "name": "Item #2",
                "description": "Description Item #2",
                "total_amount": {
                    "original_amount": 115000,
                    "amount": 115000,
                    "total_discount": 0,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "quantity": 1,
                "image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
                "taxable": true
            }
        ],
        "sub_total": 200000,
        "tax_amount": 30000,
        "total_tax_amount": 30000,
        "total_amount": 230000,
        "store_code": "all",
        "billing_address": {
            "id": "4255",
            "first_name": "Omar",
            "last_name": "Guzhnay",
            "email": "omar_guzhnay@gmail.com",
            "address1": "Rua Visconde de Pirajá, 123, apto 12",
            "address2": "apto 12",
            "zipcode": "22410001",
            "city": "Rio de Janeiro",
            "state_code": "RJ",
            "state_name": "Rio de Janeiro",
            "country_code": "BR",
            "identity_document": "12345678000195",
            "identity_document_type": "CNPJ",
            "phone": "+5511985176644",
            "lat": -22.943934,
            "lng": -43.182984,
            "additional_description": "confirm",
            "address_type": "home"
        }
    }
}

Solicitud con tipo de iniciador

JSON

{
    "payer_info": {
        "email": "omar_guzhnay@gmail.com"
    },
    "order_type": "DEUNA_NOW",
    "payment_source": {
        "method_type": "credit_card",
        "card_info": {
            "expiry_month": "12",
            "expiry_year": "2026",
            "card_holder_dni": "12345678000195",
            "card_holder": "Omar Guzhnay",
            "card_number": "4024007197692931",
            "card_cvv": "123",
            "address1": "Rua Visconde de Pirajá, 123, apto 12",
            "address2": "apto 12",
            "zip": "22410001",
            "city": "MIGUEL HIDALGO",
            "state": "CIUDAD DE MÉXICO",
            "country": "BR",
            "phone": "+5511985176644",
            "installments": 1
        }
    },
    "order": {
        "order_id": "6eab785f-c0c6-4e04-9021-b296b8a36611",
        "currency": "BRL",
        "statement_descriptor":"test",
        "market_type": "ecommerce",
        "initiator_type": "customer", //customer or merchant
        "items": [
            {
                "id": "00ab2d23-f44a-4782-aa7c-bb4fadeddfe3",
                "name": "Item #1",
                "description": "Description Item #1",
                "total_amount": {
                    "original_amount": 115000,
                    "amount": 115000,
                    "total_discount": 0,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "quantity": 1,
                "image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
                "taxable": true
            },
            {
                "id": "3cb41aec-1be8-4255-a386-94bb316a8157",
                "name": "Item #2",
                "description": "Description Item #2",
                "total_amount": {
                    "original_amount": 115000,
                    "amount": 115000,
                    "total_discount": 0,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "quantity": 1,
                "image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
                "taxable": true
            }
        ],
        "sub_total": 200000,
        "tax_amount": 30000,
        "total_tax_amount": 30000,
        "total_amount": 230000,
        "store_code": "all",
        "billing_address": {
            "id": "4255",
            "first_name": "Omar",
            "last_name": "Guzhnay",
            "email": "omar_guzhnay@gmail.com",
            "address1": "Rua Visconde de Pirajá, 123, apto 12",
            "address2": "apto 12",
            "zipcode": "22410001",
            "city": "Rio de Janeiro",
            "state_code": "RJ",
            "state_name": "Rio de Janeiro",
            "country_code": "BR",
            "identity_document": "12345678000195",
            "identity_document_type": "CNPJ",
            "phone": "+5511985176644",
            "lat": -22.943934,
            "lng": -43.182984,
            "additional_description": "confirm",
            "address_type": "home"
        }
    }
}

Solicitud con recurrencia

JSON

{
    "payer_info": {
        "email": "omar_guzhnay@gmail.com"
    },
    "order_type": "DEUNA_NOW",
    "payment_source": {
        "method_type": "credit_card",
        "card_info": {
            "expiry_month": "12",
            "expiry_year": "2026",
            "card_holder_dni": "12345678000195",
            "card_holder": "Omar Guzhnay",
            "card_number": "4024007197692931",
            "card_cvv": "123",
            "address1": "Rua Visconde de Pirajá, 123, apto 12",
            "address2": "apto 12",
            "zip": "22410001",
            "city": "MIGUEL HIDALGO",
            "state": "CIUDAD DE MÉXICO",
            "country": "BR",
            "phone": "+5511985176644",
            "installments": 1
        }
    },
    "order": {
        "order_id": "6eab785f-c0c6-4e04-9021-b296b8a36611",
        "currency": "BRL",
        "statement_descriptor":"test",
        "market_type": "ecommerce",
        "recurrence": {
            "first_time_use": true   //true = first or false=subsequent
        },
        "items": [
            {
                "id": "00ab2d23-f44a-4782-aa7c-bb4fadeddfe3",
                "name": "Item #1",
                "description": "Description Item #1",
                "total_amount": {
                    "original_amount": 115000,
                    "amount": 115000,
                    "total_discount": 0,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "quantity": 1,
                "image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
                "taxable": true
            },
            {
                "id": "3cb41aec-1be8-4255-a386-94bb316a8157",
                "name": "Item #2",
                "description": "Description Item #2",
                "total_amount": {
                    "original_amount": 115000,
                    "amount": 115000,
                    "total_discount": 0,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "unit_price": {
                    "amount": 100000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "tax_amount": {
                    "amount": 15000,
                    "currency": "BRL",
                    "currency_symbol": "R$"
                },
                "quantity": 1,
                "image_url": "https://cdn.prod.website-files.com/66269d6696cb4969aa25e070/662d847fb61e3145e2b2f640_Logo%20DEUNA.svg",
                "taxable": true
            }
        ],
        "sub_total": 200000,
        "tax_amount": 30000,
        "total_tax_amount": 30000,
        "total_amount": 230000,
        "store_code": "all",
        "billing_address": {
            "id": "4255",
            "first_name": "Omar",
            "last_name": "Guzhnay",
            "email": "omar_guzhnay@gmail.com",
            "address1": "Rua Visconde de Pirajá, 123, apto 12",
            "address2": "apto 12",
            "zipcode": "22410001",
            "city": "Rio de Janeiro",
            "state_code": "RJ",
            "state_name": "Rio de Janeiro",
            "country_code": "BR",
            "identity_document": "12345678000195",
            "identity_document_type": "CNPJ",
            "phone": "+5511985176644",
            "lat": -22.943934,
            "lng": -43.182984,
            "additional_description": "confirm",
            "address_type": "home"
        }
    }
}

Consideraciones especiales y limitaciones#

dirección de facturación

Las transacciones nacionales adquiridas por Cielo deben incluir la siguiente información del comprador en la solicitud de autorización:

billing_address.zipcode
billing_address.state_name
billing_address.country_code

Esto sigue la regulación local para retener impuestos en la provincia del comprador. Cuando no se proporcionan estos datos, Cielo retiene impuestos según la ubicación del comerciante.

Envíe cualquiera de los códigos:

Código de provincia COMARB	Código de provincia ISO	Nombre de la provincia
901	AR-C	CABA
909	AR-P	Formosa
919	AR-D	sanluis
908	AR-E	Entre Ríos
911	AR-L	La Pampa
917	AR-A	Salta
906	AR-H	Chaco
907	AR-U	Chubut
910	AR-Y	Jujuy
920	AR-Z	santa cruz
903	AR-K	Catamarca
904	AR-X	Córdoba
912	AR-F	Rioja
922	AR-G	santiago del estero
918	AR-J	san juan
913	AR-M	Mendoza
914	AR-N	Misiones
915	AR-Q	Neuquén
916	AR-R	Río Negro
923	AR-V	Tierra del Fuego
902	AR-B	buenos aires
921	AR-S	Santa Fé
924	AR-T	Tucumán
905	AR-W	Corrientes

Código de moneda: especifica el código de moneda (ISO 4217) para el país correspondiente.
Código de país: especifica el Códigos ISO de países
El número de cuotas se valida contra el número máximo de cuotas acordado con el adquirente.
Un pago que es AUTHORIZED puede ser capturado.
Se puede realizar una captura parcial si es necesario.
Cada pago autorizado permite una captura parcial o total.
Se recomienda capturar un pedido dentro de los 5 días posteriores a la autorización para evitar su vencimiento.
Se puede solicitar un reembolso sólo después de que el pago llegue al CAPTURED status.
Los reembolsos no pueden exceder el monto capturado original, pero se pueden realizar uno o más reembolsos parciales del monto capturado.
Solo se puede enviar un reembolso parcial por pedido.
Un pago puede cancelarse (anularse) sólo después de que alcance el AUTHORIZED status.
La cancelación ya no es posible una vez que el pago llega al CAPTURED status.
Se puede enviar una cancelación completa (anulación) por pedido.
El initiator type El campo es crucial para indicar quién inició la transacción, lo que tiene implicaciones para el flujo de la transacción y mejora la tasa de conversión. Los dos valores posibles son:
1. customer: Este valor se refiere a una transacción donde el titular de la tarjeta (el cliente) está presente e interactúa para iniciar la compra.
2. merchant: Este valor se refiere a una transacción en la que el comerciante (o proveedor de servicios) inicia el uso de la tarjeta almacenada del cliente, sin interacción directa con el cliente en ese momento.
pedidos con el recurrence objeto presentar diferenciación entre el primer pago y los siguientes.
1. El primer pago se clasifica por tipo. recurrence.first_time_use = true.
2. Los pagos posteriores se identifican por el tipo recurrence.first_time_use = false.
3. Nota: La adición del parámetro recurrence.first_time_use no está vinculado ni condicionado a la API de Pago Recurrente.
Antes de realizar pagos en América Latina se requiere una entidad legal y un adquirente en el país de operación.

Recursos de prueba#

Credenciales de cielo

ABAP

External Merchant ID: 8937bd5b-9796-494d-9fe5-f76b3e4da633
Private API Key: XKGHUBSBKIRXKAVPSKWLVXYCLVJUGTNZLIHPUSYV

Colección de Postman

Solicita el entorno y cobro actual de Cielo Postman a tu equipo de integración de DEUNA.

Tarjetas de prueba

Marca	Tipo	Número de tarjeta	Mes de vencimiento	Año de vencimiento	CVV
visa	Aprobado	4024007197692931	12	2026	123
maestro	Aprobado	5555666677778884	12	2026	123
visa	Rechazado	4000000000002503	12	2026	123
maestro	Rechazado	5200000000002235	12	2026	123