Konduto

Credenciales requeridas#

Como se menciona en el capítulo sobre "Descripción general: credenciales requeridas", cada institución tiene un conjunto de credenciales que deben obtenerse para la integración. Los servicios de Konduto requieren las siguientes credenciales:

Clave privada (Identificación de la tienda) - Clave privada del registro de la tienda Konduto.
Clave pública (Merchant Code) - Clave pública del registro de la tienda Konduto.

IMPORTANTE: Las credenciales anteriores deben obtenerse de Konduto. El comerciante debe comunicarse con Konduto y recibir la orientación adecuada sobre cómo obtener cada una de estas credenciales. Después de obtener las credenciales, el comerciante debe comunicarse con el soporte de la cuenta de Portal Carat y pasar las credenciales al registro de Portal Carat.

Configuración de URL de enlace web#

Para que podamos recibir actualizaciones de estado para las transacciones de análisis de riesgo, es necesario configurar la URL de Webhook en el entorno de configuración de Konduto.

URL de producción:

https://esitef-ec.softwareexpress.com.br/e-sitef/processarPost.se?src=konduto

URL de aprobación:

https://esitef-homologacao.softwareexpress.com.br/e-sitef/processarPost.se?src=konduto

Esta URL debe configurarse para cualquier intercambio de estado. Para realizar esta configuración, comuníquese con el Soporte de Konduto.

Bandeiras permitidas#

Konduto admite cualquier marca de tarjeta.

IMPORTANTE: Solo las transacciones de crédito serán analizadas eficazmente por Konduto. Las transacciones de débito se enviarán a la institución, pero solo se almacenarán para informar y no se analizarán.

Funciones compatibles#

Parámetros antifraude de Konduto (Link de pago HTML)#

Por ahora, los datos recopilados para el análisis de riesgos solo se informarán durante el checkout del comprador. Pronto, se pueden enviar nuevos campos en la solicitud de creación de pago.

Campos recopilados durante el checkout#

Los campos recopilados durante el checkout son:

Campo	Descripción del campo	Obligatorio
`Primeiro Nome do Comprador`	Primero nombre del cliente que realiza a compra	Si
`Sobrenome do Comprador`	Apellidos del cliente que realiza a compra	Si
`CPF do Comprador`	CPF del cliente que realiza a compra	Si
`Telefone`	Teléfono del cliente que realiza a compra	Si
`E-mail`	E-mail del cliente que realiza a compra	Si
`Nome (como está no cartão)`	Nombre que esta impreso en la tarjeta utilizado para la compra.	Si
`Endereco completo`	Dirección de facturación completa	Si
`Complemento`	Complemento de la dirección de facturación.	No
`CEP`	Código postal de la dirección de facturación.	Si
`País`	País de la dirección de facturación.	Si
`Estado`	Estado de la dirección de facturación.	Si
`Cidade`	Cidade de la dirección de facturación.	Si

Ejemplo#

Ejemplo de solicitud de pago HTML con análisis de riesgo en Konduto:

{
  "merchant_id": "KONDUTOTESTE",
  "merchant_usn": "803208495",
  "order_id": "866705726000010",
  "redirect": "A",
  "style": "N",
  "amount": "100000",
  "authenticate": "0",
  "transaction_type": "payment",
  "payment_link": "true",
  "additional_data": {
    "currency": "BRL",
    "anti_fraud": "enabled_after_auth"
  }
}

Anti-Fraud Konduto en el Link de Pago via Portal#

Para habilitar el antifraude Konduto para los links de pago generados por el Portal de comerciantes, comuníquese con el soporte de Portal Carat.

Konduto Antifraud vía REST#

Después de realizar la alineación del registro con el soporte en línea de Portal Carat para habilitar la integración con el servicio antifraude, en la inicialización de un Pago REST (más información) o una transacción de Autorización previa REST (más información) el comerciante debe enviar la propiedad anti_fraud y enviar los parámetros antifraude apropiados (depende de la institución para la que se haya configurado su tienda), y ambas propiedades deben estar en el alcance del objeto additional_data.

El campo anti_fraud determina el modo de aplicación antifraude y puede contener los siguientes valores:

enabled_before_auth: el análisis antifraude se realizará ANTES de la autorización del pago. Si se rechaza el análisis, no se iniciará el pago. En el caso de preautorización con rutas no SiTef, si el análisis de riesgo queda como análisis manual, Portal Carat deja la transacción en estado PPC (Pago Pendiente de Confirmación) y espera la finalización del análisis manual.
enabled_after_auth: el análisis antifraude se realizará DESPUÉS de la autorización del pago. Si se rechaza el análisis, se cancelará el pago que ya ha sido autorizado. En el caso de preautorización con rutas que no son SiTef, Portal Carat deja la transacción en estado PPC (Pago Pendiente de Confirmación) y espera la finalización del análisis manual.

Parámetros antifraude de Konduto#

A continuación se muestra la lista de parámetros antifraude procesados por Konduto.

Nota: Si el pagador, el envío y las estructuras de datos de facturación se informan en la llamada HTML, no se solicitarán en la pantalla de pago.

Datos adicionales de transaccion Información sobre artículos de compra Información del comprador Información del teléfono del comprador Información de la factura Información de entrega Información sobre la dirección de envío Información sobre tarifas aéreas Información sobre conexiones de viaje Información del pasajero Información de reserva de hotel Información sobre la dirección del hotel Información de las habitaciones del hotel Información de los huéspedes de la habitación Información relacionada con los datos del evento Información sobre los datos de ubicación de un evento Información de entradas para eventos Información de los participantes del evento

Parámetro	Descripción	Requerido	Formato
`additional_data`
`visitor_id`	Identificador de visitante obtenido del JavaScript del Konduto	NO	< 40 AN
`additional_data` `.items[]` `.items []`**
`unit_price`	Precio unitario del artículo en centavos	NO	< 10 N
`sku`	Artículo Código de producto	NO	< 100 AN
`quantity`	Cantidad de artículos	NO	< 10 N
`id`	Identificación única del artículo que puede ser el código de barras o UPC del producto.	NO	< 100 AN
`title`	Nombre del producto o servicio	NO	< 100 AN
`discount_amount`	Importe de descuento del producto en centavos	NO	< 10 N
`description`	Descripción del producto	NO	< 100 AN
`creation_date`	Indica la fecha de publicación del producto en el sitio web de la tienda (Formato: `DD / MM / AAAA`)	NO	= 10 AN
`additional_data` `.payer`
`id`	Identificador único del cliente. Puede tener cualquier valor (secuencial, documento, correo electrónico) siempre que sea coherente en pedidos futuros.	SI	< 100 AN
`name`	Nombre del cliente	SI	< 100 AN
`surname`	Apellido del cliente	SI	< 100 AN
`email`	Dirección de correo electrónico del cliente	SI	< 100 AN
`born_date`	Fecha de nacimiento del cliente (formato: `AAAA-MM-DDTHH: MM: SS`)	NO	= 19 AN
`identification_number`	Número de documento fiscal del cliente	NO	< 100 AN
`creation_date`	Fecha de creación de la cuenta o registro del cliente en el sitio web (formato: `DD / MM / AAAA`)	NO	= 10 AN
`is_new_client`	Booleano que indica si el cliente está utilizando una cuenta recién creada para esta compra	NO	< 5 T / F
`is_vip_client`	Booleano que indica si se trata de un cliente VIP o un comprador frecuente.	NO	< 5 T / F
`additional_data` `.payer` `.phones[]`
`ddi`	IDD del teléfono del cliente	NO	< 100 AN
`ddd`	Código de área de teléfono del cliente	NO	< 100 AN
`number`	Número de teléfono del cliente	NO	< 100 AN
`additional_data` `.billing_data` `.address`
`street_name`	Calle de la factura del cliente con el banco	NO	< 255 AN
`street_number`	Número de calle de la factura del cliente con el banco	NO	< 255 AN
`complement`	Complemento de dirección de factura.	NO	< 100 AN
`city`	Ciudad de Holder	NO	< 100 AN
`state`	Estado del titular	NO	< 100 AN
`zip_code`	Código postal del propietario	NO	< 100 A N
`country`	Código de país del titular, según [ISO 3166-1 alpha-3] (https://pt.wikipedia.org/wiki/ISO_3166-1_alfa-3)	NO	= 3 AN
`additional_data` `.shipment`
`name`	Nombre del destinatario	NO	< 100 AN
`surname`	Apellido del destinatario	NO	< 100 AN
`additional_data` `.shipment` `.address`
`street_name`	Nombre de la calle del destinatario	NO	< 255 AN
`street_number`	Número de la calle del destinatario	NO	< 255 AN
`complement`	Complemento de la dirección del destinatario.	NO	< 255 AN
`city`	Ciudad receptora	NO	< 100 AN
`state`	Estado del destinatario	NO	< 100 AN
`zip_code`	Código postal del destinatario	NO	< 100 AN
`country`	Código de país del destinatario según [ISO 3166-1 alpha-3] (https://pt.wikipedia.org/wiki/ISO_3166-1_alfa-3)
`additional_data` `.travel`
`transport_type`	Tipo de viaje (`flight` ou `bus`)	SI	< 6 AN
`expiration_date`	Fecha de caducidad (formato: `DD / MM / AAAA`)	NO	= 10 AN
`additional_data` `.connections[]`
`journey_type`	`OUTWARD` - para el exterior `RETURN` - para el retorno	SI	< 7 AN
`origin_city`	Ciudad de origen.	SÍ, si `transport_type` = `bus`	< 100 AN
`destination_city`	Ciudad de destino.	SÍ, si `transport_type` = `bus`	< 100 AN
`from`	[Código de aeropuerto IATA] (https://pt.wikipedia.org/wiki/C%C3%B3digo_aeroportu%C3%A1rio_IATA) para el aeropuerto de origen	SÍ, si `transport_type` = `flight`	= 3 AN
`to`	[Código de aeropuerto IATA] (https://pt.wikipedia.org/wiki/C%C3%B3digo_aeroportu%C3%A1rio_IATA) para el aeropuerto de destino.	SÍ, si `transport_type` = `flight`	= 3 AN
`departure_date`	Fecha y hora de envío (formato: `AAAA-MM-DDTHH: MM: SS`)	SI	< 17 AN
`class`	Nombre de la clase (Ex: `economy`, `business` e `first`)	NO	< 8 AN
`class_code`	Código de clase	NO	< 20 AN
`company`	Nombre de la compañía aérea	NO	< 20 AN
`additional_data` `.passengers[]`
`name`	Nombre del pasajero	SI	< 100 AN
`last_name`	Apellido del pasajero	SI	< 100 AN
`legal_document`	Número de documento	SI	< 100 AN
`legal_document_type`	Tipo de documento (5 = pasaporte, cualquier otro número = id)	SI	< 8 AN
`birth_date`	Fecha de nacimiento del pasajero (formato: `AAAA-MM-DDTHH: MM: SS`)	NO	< 17 AN
`nationality`	País de nacimiento del pasajero, según [ISO 3166-1 alpha-3] (https://pt.wikipedia.org/wiki/ISO_3166-1_alfa-3)	NO	= 3 AN
`is_frequent_traveler`	Flag de viajero frecuente	NO	< 5 T / F
`is_with_special_needs`	Flag de viajero con necesidades especiales	NO	< 5 T / F
`frequent_flyer_card`	Tipo de programa de fidelización	NO	< 255 AN
`customer_class`	Categoría del programa de fidelización	NO	< 255 AN
`additional_data` `.hotel_reservations[]`
`hotel`	Nombre del hotel	SI	< 100 AN
`categoría`	Categoría de hotel	NO	< 100 AN
`additional_data` `.hotel_reservations []` `.address`
`street_name`	Calle del hotel	NO	< 255 AN
`street_number`	Número de hotel	NO	< 255 AN
`complement`	Complemento de la dirección del hotel.	NO	< 100 AN
`city`	Hotel City	NO	< 100 AN
`state`	Acrónimo de Hotel State	NO	< 100 AN
`zip_code`	Código postal del hotel	NO	< 100 AN
`country`	País del hotel, según [ISO 3166-1 alpha-3] (https://pt.wikipedia.org/wiki/ISO_3166-1_alfa-3).	NO	= 3 AN
`additional_data` `.hotel_reservations[]` `.rooms[]`
`number`	Número de habitación	NO	< 100 AN
`code`	Código de habitación	NO	< 100 AN
`type`	Tipo de habitación	NO	< 100 AN
`check_in_date`	Fecha y hora de entrada (formato: `AAAA-MM-DDTHH: MM: SS`)	SI	< 17 AN
`check_out_date`	Fecha y hora de salida (formato: `AAAA-MM-DDTHH: MM: SS`)	NO	< 17 AN
`number_of_guests`	Numero de personas	NO	< 9999 N
`board_basis`	Régimen de alimentación	NO	< 100 AN
`additional_data` `.hotel_reservations[]` `.rooms[]` `.guests[]`
`name`	Nombre de invitado	SI	< 100 AN
`document`	Número de documento de invitado	NO	< 8 AN
`document_type`	Documento utilizado por el cliente: `cpf` `rg` `pasaporte` `id` `otro`	NO	< 8 AN
`birth_date`	Fecha de nacimiento del cliente (formato: `AAAA-MM-DDTHH: MM: SS`)	NO	< 17 AN
`nationality`	Nacionalidad del invitado, según [ISO 3166-1 alpha-3] (https://pt.wikipedia.org/wiki/ISO_3166-1_alfa-3).	NO	= 3 AN
`additional_data` `.events[]`
`name`	Nombre del evento	SI	< 255 AN
`date`	Fecha y hora del evento en UTC (formato `AAAA-MM-DDTHH: MM: SS`)	SI	< 17 AN
`type`	Tipo de evento: `espectáculo` `teatro` `películas` `fiesta` `festival` `curso` `deportes` `corporativo`	SI	< 9 AN
`subtype`	Detalle del tipo de evento	NO	< 255 AN
`additional_data` `.events[]` `.venue`
`name`	Nombre de la ubicación	NO	< 255 AN
`street_name`	Nombre de la calle	NO	< 255 AN
`street_number`	Número de calle	NO	< 255 AN
`city`	Ciudad del lugar	NO	< 255 AN
`state`	Estado de la ubicación	NO	< 255 AN
`country`	País de ubicación, siguiendo [ISO 3166-1 alpha-3] (https://pt.wikipedia.org/wiki/ISO_3166-1_alfa-3).	NO	= 3 AN
`cpacity`	Capacidad de la ubicación	NO	< 255 AN
`additional_data` `.events[]` `.tickets[]`
`id`	Identificador único del ticket.	NO	< 255 AN
`category`	Categoría de entrada: `estudiante` `senior` `gobierno` `social` `regular`	SI	< 10 AN
`section`	Sección de entradas	NO	< 255 AN
`premium`	Indicador de entrada premium	NO	< 5 T / F
`additional_data` `.events[]` `.tickets[]` `.atendee`
`name`	Nombre del participante	NO	< 255 AN
`document`	Documento del participante	SI	< 100 AN
`document_type`	Tipo de documento del participante: `cpf` `cnpj` `rg` `pasaporte` `otro`	NO	< 100 AN
`birth_date`	Fecha de nacimiento del participante (formato: `AAAA-MM-DDTHH: MM: SS`)	NO	< 17 AN

ATENCIÓN: Los parámetros que existan en payer, billing y shipping cuando no se pasen en el servicio de creación de transacciones a través de additional_data, serán solicitados en la pantalla de pago. Si los parámetros se pasan en el servicio de creación de transacciones, no se le pedirá que complete los campos en la pantalla de pago.

Ejemplo#

Ejemplo de solicitud de creación de pago REST con análisis de riesgo en Konduto:

{
  "merchant_usn": "2423423434",
  "order_id": "2432342343",
  "installments": "1",
  "installment_type": "4",
  "authorizer_id": "2",
  "amount": "1300",
  "additional_data": {
    "anti_fraud": "enabled_before_auth",
    "visitor_id": "XKhas09jcks",
    "items": [
      {
        "title": "title1",
        "quantity": "1",
        "unit_price": "1111",
        "description": "description1",
        "id": "id1",
        "discount_amount": "111",
        "sku": "sku1",
        "creation_date": "11/01/2011"
      }
    ],
    "payer": {
      "name": "Marcos",
      "surname": "da Silva",
      "email": "marocs@dasilva.com",
      "born_date": "1990-01-01T11:11:11",
      "creation_date": "02/03/2004",
      "is_new_client": "true",
      "is_vip_client": "true",
      "phones": [
        {
          "number": "333333333",
          "ddd": "22",
          "ddi": "11"
        },
        {
          "number": "666666666",
          "ddd": "55",
          "ddi": "44"
        }
      ],
      "identification_number": "47764543004"
    },
    "shipment": {
      "name": "Fernando",
      "surname": "Bezerra",
      "address": {
        "zip_code": "98764312",
        "street_number": "987",
        "street_name": "Rua Shipment",
        "complement": "ap. 587",
        "city": "São Shipment",
        "state": "MA",
        "country": "BRA"
      }
    },
    "passengers": [
      {
        "name": "Miguel",
        "last_name": "Herrera",
        "frequent_flyer_card": "frequentFlyerCard",
        "legal_document_type": "1",
        "legal_document": "12312312312",
        "birth_date": "1980-07-28T10:40:00",
        "customer_class": "customerClass",
        "nationality": "BRA",
        "is_frequent_traveler": "true",
        "is_with_special_needs": "true"
      }
    ],
    "connections": [
      {
        "company": "Verde",
        "class": "first",
        "from": "GRU",
        "to": "CGH",
        "departure_date": "2023-09-07T07:09:00",
        "journey_type": "OUTWARD",
        "origin_city": "San Juan",
        "destination_city": "Homero Lopez",
        "class_code": "VIP"
      },
      {
        "company": "Rosa",
        "class": "economy",
        "from": "BSB",
        "to": "VCP",
        "departure_date": "2022-10-21T16:39:00",
        "journey_type": "RETURN",
        "origin_city": "San Pablo",
        "destination_city": "Juanito Cruz",
        "class_code": "ECONOMY"
      }
    ],
    "hotel_reservations": [
      {
        "hotel": "Hotel Green Tree",
        "address": {
          "zip_code": "83392019",
          "street_number": "529",
          "street_name": "Rua Hoteleira",
          "complement": "ap. 019",
          "city": "San Hotel",
          "state": "AC",
          "country": "EN"
        },
        "rooms": [
          {
            "number": "902",
            "code": "ROOM902",
            "type": "King Size",
            "check_in_date": "2020-01-09T12:30:00",
            "check_out_date": "2020-01-19T13:00:00",
            "number_of_guests": "1",
            "board_basis": "Vegan",
            "guests": [
              {
                "name": "José Aníbal",
                "document": "98798798712",
                "document_type": "cpf",
                "birth_date": "12/03/1970",
                "nationality": "BRA"
              }
            ]
          }
        ],
        "category": "categoryhotel"
      }
    ],
    "billing_data": {
      "address": {
        "zip_code": "12341234",
        "street_number": "666",
        "street_name": "Rua Billing",
        "complement": "ap. 2369",
        "city": "São Billing",
        "state": "AM",
        "country": "BRA"
      }
    },
    "travel": {
      "transport_type": "flight",
      "expiration_date": "2022-02-14T01:30:00"
    },
    "discount_info": "Informações de desconto",
    "events": [
      {
        "name": "Evento de Rock",
        "date": "2021-11-22T09:28:00",
        "type": "show",
        "subtype": "music",
        "venue": {
          "name": "Debicard Hall",
          "street_name": "Rua do Evento",
          "street_number": "928",
          "city": "Jardinópolis",
          "state": "MS",
          "country": "DO",
          "capacity": "300"
        },
        "tickets": [
          {
            "id": "12h374612h4h",
            "category": "social",
            "section": "Seção 1",
            "premium": "true",
            "attendee": {
              "name": "Daniel Almeida",
              "document": "71728293945",
              "document_type": "other",
              "birth_date": "03/10/1990"
            }
          }
        ]
      }
    ]
  }
}