Servicio de análisis de riesgos en la interfaz HTML

Después de realizar la alineación del registro con el soporte del Portal Carat para permitir la integración con el servicio antifraude, al inicio de una transacción de pago HTML [(Más información)] (pagamento-html-begin) el comerciante debe configurar la propiedad anti_fraud y enviar los parámetros antifraude apropiados (depende de la institución en la que se haya creado su tienda), 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.
• 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.

Atención:

Para los casos en los que los límites de intervalos para la activación automática de Antifraude estén configurados en la tienda y se pase un valor anti_fraud en la creación de la transacción, Portal Carat solo aceptará el valor de anti_fraud pasado si la transacción se encuentra entre los límites de activación. Y si los límites de tiempo para la activación automática Antifraude están configurados en la tienda y no se pasa un valor anti_fraud en la transacción, el valor enabled_after_auth se asumirá como predeterminado para el tipo antifraude. Importante: no se deben utilizar intervalos que permitan el uso conjunto de 3ds y antifraude.

Parámetros antifraude

Los parámetros dependen de la institución que presta el servicio antifraude. Por lo tanto, no se utilizarán de forma eficaz todos los parámetros antifraude disponibles en Portal Carat.

A continuación se muestran todos los parámetros antifraude (independientemente de la institución) . Algunos parámetros pueden aparecer repetidamente (por ejemplo, la propiedad gift) y esto se debe a la característica de análisis de riesgo de cada institución. Para obtener más detalles sobre cómo cada institución utiliza cada parámetro antifraude, consulte la página de cada integración antifraude.

Propiedades	Descripción	Formato	Requerido
currency	Moneda a utilizar	3 A	Si
b2b_b2c	Marca de comercio electrónico	3 A	No
item_amount	Valor en centavos de la suma total de los valores de los artículos	< 1024 N	Si
total_order_amount	Valor en los centros de pedidos	< 1024 N	Si
delivery_time_cd	Tiempo de entrega	< 50 A	No
qty_payment_types	Monto de los pagos	1 N	No
ip (deprecated)	Solicitar IP	< 50 A	Si
gift	1 - Es un regalo 0 - No es un regalo	1 N	No
reservation_date	Fecha del Primer Vuelo del Pedido (en caso de boleto aéreos).	< 200 A	No
sequential	Secuencia de pago	1 N	No
interés	Tasa de interés. Ejemplo: 5,00	< 4 N	No
interest_value	Valor absoluto de interés en centavos. Ejemplo: 1000 (10 reales).	< 20 N	No
shipping_type	ID del tipo de entrega. Puede ser: 0 - Otros 1 - Normal 2 - Garantizado 3 - ExpressaBR 4 - ExpressaSP 5 - Alto 6 - Económico 7 - Programado 8 - Extra rápido 9 - Impreso 10 - Aplicación 11 - Correo 12 - Servicio de mensajería en motocicleta 13 - Recogida en taquilla 14 - Recogida en tienda asociada 15 - Tarjeta de crédito del boleto 16 - Retiro de la tienda	< 2 N	No
items	Información sobre artículos de compra	Arrays de objetos json [(Más información)] (# object-items)	Si
payer	Información del pagador	json object [(Más información)] (# payer-object)	Si
billing_data	Información de la factura	json object [(Más información)] (# object-billing_data)	Si
shipment	Información de entrega	matriz de objetos json [(Más información)] (# objeto-envío)	Si
browser	Información sobre el navegador utilizado para la compra	json object [(Más información)] (# browser-object)	Si
travel	Información de tarifas aéreas	json object [(Más información)] (# object-travel)	Condicional por institución
passengers	Información del pasajero	Array de objetos json [(Más información)] (#objeto-passengers)	Sí, si el artículo es pasaje aéreo
connections	Información sobre el navegador utilizado para la compra	Array de objetos json [(Más información)] (#objeto-connections)	Sí, si el artículo es pasaje aéreo
hotel_reservations	Información de reserva de hotel	matriz de objetos json [(Más información)] (# object-hotel_reservations)	Sí, si la compra es una reserva de hotel
purchase_data	Información sobre la fecha de compra	json object [(Más información)] (# object-purchase_data)	Si
mdd	Información relacionada con mdd (datos comerciales). Campo específico de Cybersource	Array de objetos json [(Más información)] (# object-mdd)	No

Objetos items

Propiedades	Descripción	Formato	Requerido
id	Identificación única del artículo	N	Si
sku	Código de producto del artículo.	A	Condicional por institución
title	Nombre del producto	A	Si
description	Descripción del producto	A	No
quantity	Cantidad de artículos	< 4 N	Si
unit_price	Precio unitario del artículo	< 12 N	Si
category_id	ID de categoría de artículo Cada institución de revisión tiene una interpretación diferente.	Condicional por institución	Condicional por institución
category_name	Nombre de categoría de producto	< 200 A	No
gift	1 - Es un regalo 0 - No es un regalo	1 N	No
tax_amount	Importe de la tarifa	N	No
discount_amount	Importe de descuento en centavos	N	No
creation_date	Fecha de publicación del producto en formato "DD / MM / AAAA".	AN	No

Objeto payer

Propiedades	Descripción	Formato	Requerido
id	Identificación del comprador. Suele ser el CPF.	N	Si
name	Nombre del comprador. Cada institución de revisión tiene una interpretación diferente.	Condicional por institución	Condicional por institución
surname	Apellido del comprador	< 200 A	Si
email	Correo electrónico del comprador	A	Si
date_created	Fecha de creación	A	Si
password	Contraseña del comprador	Condicional por institución	Condicional por institución
city	Dirección ciudad sin abreviaturas	< 150 A	Si
address_street_complement	Complemento de direcciones sin abreviaturas	< 250 A	No
address_country	Dirección del país sin abreviaturas	< 150 A	No
address_county	Barrio de la dirección sin abreviaturas	< 150 A	No
address_street_number	Número de dirección	< 15 A	No
state	Dirección Estado Acrónimo - UF	2 A	No
address_street_name	Nombre del lugar (sin abreviaturas)	< 200 A	No
address_zip_code	Dirección código postal	< 10 N	No
address_reference	Referencia de dirección (sin abreviaturas)	< 250 A	No
legal_document	Documento de la persona que factura	< 100 A	No
phones	Contactos telefónicos del comprador	matriz de objetos json (Más información)	No
address	Dirección del comprador	json object (Más información)	No

Objeto phones del payer

Propiedades	Descripción	Formato	Obligatorio
ddi	Código del teléfono	3 N	No
ddd	Código de área de teléfono	3 N	No
number	Número de teléfono	9 N	No

Objeto address del payer

Propiedades	Descripción	Formato	Obligatorio
street_name	Nombre de la calle.	< 200 A	Si
street_name2	Complemento del nombre de la calle.	< 200 A	No
street_number	Número de dirección	< 15 A	Si
apartment	Apartamento si lo hubiera	N	No
complement	Complemento de direcciones sin abreviaturas	< 250 A	No
county	Barrio de la dirección sin abreviaturas	< 150 A	Si
city	Dirección ciudad sin abreviaturas	< 150 A	Si
state	Dirección Estado Acrónimo - UF	2 A	Si
district	Distrito, si lo hay	A	No
country	País de dirección	< 150 A	No
zip_code	Código postal de la dirección	< 10 N	Si
referencia	Referencia de dirección sin abreviaturas	< 250 A	No
building_number	Número de casa. Ejemplo: si es un condominio cerrado, sería el número de casa dentro de este condominio.	< 10 A	No

Objeto billing_data

Propiedades	Descripción	Formato	Obligatorio
client_id	Código de cliente	< 50 A	Si
person	1 - Persona física 2 - Entidad jurídica	1 N	Si
cnpj_cpf	CPF o CNPJ	< 100 A	Si
identification_number	RG o registro estatal	< 100 A	No
name	Nombre del cliente	< 500 A	Si
birth_date	Fecha de nacimiento.	Fecha en el formato: aaaa-mm-ddThh: mm: ss	Si
email	Correo electrónico	< 150 A	No
gender	M - macho F - hembra	1 A	No
address	Dirección de la factura	json object [(Más información)] (# object-address-do-billing_data)	No
phones	Factura contactos telefónicos	Array de objetos json [(Más información)] (# object-phones-do-billing_data)	No
documents	Documentos de factura	Array de objetos json [(Más información)] (# object-documents-do-billing_data)	No

Objeto dirección de billing_data

Propiedades	Descripción	Formato	Obligatorio
street_name	Nombre de la calle	< 200 A	Si
street_name2	Complemento del nombre de la calle.	< 200 A	No
street_number	Número de dirección	< 15 A	Si
apartment	Apartamento si lo hubiera	N	No
complement	Complemento de direcciones sin abreviaturas	< 250 A	No
county	Barrio de la dirección sin abreviaturas	< 150 A	Si
city	Dirección ciudad sin abreviaturas	< 150 A	Si
state	Dirección Estado Acrónimo - UF	2 A	Si
district	Distrito, si lo hay	A	No
country	Dirección del país sin abreviaturas.	< 150 A	No
zip_code	Dirección código postal	< 10 N	Si
referencia	Referencia de dirección sin abreviaturas	< 250 A	No
building_number	Número de casa. Ejemplo: si es un condominio cerrado, sería el número de casa dentro de este condominio.	< 10 A	No

Objeto phones de billing_data

Propiedades	Descripción	Formato	Obligatorio
type	Tipo de teléfono: 0 - No definido 1 - Residencial 2 - Comercial 3 - Mensajes 4 - Facturación 5 - Temporal 6 - Celular	1 N	Si
ddi	teléfono IDD	3 N	No
ddd	Código de área de teléfono	3 N	Si
number	Número de teléfono	9 N	Si
extension	Extensión telefónica	< 10 A	No

Objeto documents de billing_data

Propiedades	Descripción	Formato	Obligatorio
type	Condicional por institución.	A	No
number	Número de documento	N	Si

Objeto shipment

Propiedades	Descripción	Formato	Obligatorio
id	Código de cliente	< 50 A	Si
cost	Valor de envío en centavos	< 1024 N	No
type	Tipo de persona 1 - Persona física 2 - Persona jurídica	< 1 N	Si
legal_document1	CPF o CNPJ	< 100 A	Si
legal_document2	RG o registro estatal	< 100 A	No
name	Nombre del cliente	< 500 A	Si
surname	Apellido del cliente	< 500 A	Si
birth_date	Fecha de nacimiento.	Fecha en el formato: aaaa-mm-ddThh: mm: ss	No
email	Correo electrónico	< 150 A	No
gender	M - masculino F - femenino	1 A	No
address	Dirección de entrega	json object [(Más información)] (# object-address-do-shipping)	Condicional por institución
receiver_address	Dirección de entrega	json object [(Más información)] (# object-address-do-shipping)	Condicional por institución
phones	Contactos telefónicos de entrega	Arrays de objetos json [(Más información)] (# object-phones-do-shipping)	Si

Objeto address de shipment

También equivalente al objeto receiver_address de shipping

Propiedades	Descripción	Formato	Obligatorio
street_name	Nombre de la calle.	< 200 A	Si
street_name2	Complemento del nombre de la calle.	< 200 A	No
street_number	Número de dirección	< 15 A	Si
apartment	Apartamento si lo hubiera	N	No
complement	Complemento de direcciones sin abreviaturas	< 250 A	No
county	Barrio de la dirección sin abreviaturas	< 150 A	Si
city	Dirección ciudad sin abreviaturas	< 150 A	Si
state	Dirección Estado Acrónimo - UF	2 A	Si
country	País de domicilio.	< 150 A	Si
zip_code	Código postal de la dirección. Sólo números.	< 10 A	Si
building_number	Número de casa. Ejemplo: si es un condominio cerrado, sería el número de casa dentro de este condominio.	< 10 A	No

Objeto phones de shipment

Propiedades	Descripción	Formato	Obligatorio
type	Tipo de teléfono: 0 - no definido 1 - Residencial 2 - Comercial 3 - Mensajes 4 - Facturación 5 - Temporal 6 - Teléfono celular	1 N	Si
ddi	teléfono IDD	3 N	No
ddd	Código de área de teléfono	3 N	Si
number	Número de teléfono	9 N	Si
extension	Extensión telefónica	< 10 A	No

Explorador de objetos

Propiedades	Descripción	Formato	Obligtorio
ip_address	Dirección IP	15 A	Si

Objeto travel

departure_date_time

Objeto passengers

Propiedades	Descripción	Formato	Obligatorio
id	Id del pasajero	< 32 A	No
name	Condicional por institución	< 100 A	Si
last_name	Apellido del pasajero	< 100 A	Condicional por institución
frequente_flyer_card	Mileage Card (fidelidad)	< 32 A	No
legal_document_type	Tipo de documento de identificación: 1 - CPF 2 - CNPJ 3 - RG 4 - IE 5 - Pasaporte 6 - CTPS 7 - Título del votante	1 N	Si
legal_document	Número de documento	< 50 A	Si
birth_date	Fecha de nacimiento.	Fecha en el formato: aaaa-mm-ddThh: mm: ss	No
email	Email del pasajero. Debe ser único en el arrays de passengers.	Formato: name@domain.com	No
status	Estado de reserva de entradas. Ejemplo: Reservado	< 32 A	No
status	Clasificación de pasajeros según precio del ticket.	< 32 A	No
type	Clasificación de pasajeros. ADT: Adult CNN: Child INF: Infant YTH: Youth STU: Student SCR: jubilado MIL: militar	< 32 A	No
unit_price	Precio unitario del pasaje.	Formato (en centavos): 1000 (10 reales)	No
phones	Contactos telefónicos para pasajeros	Arrays de objetos json [(Más información)] (#objeto-phones-do-passengers)	Si

Objeto phones do passengers

Propiedades	Descripción	Formato	Obligatorio
ddi	IDD en el teléfono. Sólo números. Ejemplo: 55 (Brasil)	3 N	No
ddd	Código de área del teléfono. Sólo números. Ejemplo: 11 (São Paulo)	3 N	Si
number	Numero de teléfono. Sólo números. Ejemplo: 12345789	9 N	Si

Objeto ### connections

Propiedades	Descripción	Formato	Obligatorio
company	Nombre de la aerolínea	< 50 A	Si
flight_number	Número de vuelo	6 N	Si
flight_date	Fecha y hora de salida del primer tramo del vuelo.	Condicional por institución	Si
class	Clase de asiento	< 10 A	Si
from	Origen	Condicional por institución	Si
to	Destino	Condicional por institución	Si
departure_date	Fecha de embarque.	Fecha en el formato: aaaa-mm-ddThh: mm: ss	Si
arrival_date	Fecha de aterrizaje.	Fecha en el formato: aaaa-mm-ddThh: mm: ss	Si

Objeto hotel_reservations

Propiedades	Descripción	Formato	Obligatorio
hotel	Nombre del hotel	< 200 A	Si
city	Hotel ciudad sin abreviaturas	< 150 A	Si
state	Estado del hotel sin abreviaturas	< 150 A	Si
country	País del hotel	< 150 A	Si
reservation_date	Fecha para registrarse.	Fecha en el formato: aaaa-mm-ddThh: mm: ss	Si
reserve_expiration_date	Fecha de vencimiento de la reserva.	Fecha en el formato: aaaa-mm-ddThh: mm: ss	Si
checkin_date	Fecha de llegada.	Fecha en el formato: aaaa-mm-ddThh: mm: ss	Si
checkout_date	Fecha de salida.	Fecha en el formato: aaaa-mm-ddThh: mm: ss	Si

Objeto purchase_data

Propiedades	Descripción	Formato	Obligatorio
last_date_inserted_mail	Fecha del último cambio de email.	Fecha en el formato: yyyy-mm-ddThh:mm:ss	No
last_date_change_password	Fecha del último cambio de contaseña.	Fecha en el formato: yyyy-mm-ddThh:mm:ss	No
last_date_change_phone	Fecha del último cambio de teléfono.	Fecha en el formato: yyyy-mm-ddThh:mm:ss	No
last_date_change_mobile_phone	Fecha del último cambio de teléfono mobil	Fecha en el formato: yyyy-mm-ddThh:mm:ss	No
last_date_inserted_address	Fecha del último cambio de dirección.	Fecha en el formato: yyyy-mm-ddThh:mm:ss	No
purchase_logged	Compra conectado	1 N	No
purchase_logged_with_facebook	Compra conectado con Facebook	1 N	No

Objeto mdd

Propiedades	Descripción	Formato	Obligatorio
id	Puede ir de 1 a 100 definido por el comercio de acuerdo con Cybersource	255 A	No
value	Valor de los campos definidos por el comercio en el acuerdo con Cybersource	255 A	No

Para los pagos que utilizan Konduto, Cybersource y Antifraude Fiserv: Los parámetros que existen en payer, billing y shipment cuando no se pasan en el servicio de creación de la transacción 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 la transacción, no será necesario rellenar los campos en la pantalla de pago.