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.

PropiedadesDescripciónFormatoRequerido
currencyMoneda a utilizar3 ASi
b2b_b2cMarca de comercio electrónico3 ANo
item_amountValor en centavos de la suma total de los valores de los artículos < 1024 NSi
total_order_amountValor en los centros de pedidos < 1024 NSi
delivery_time_cdTiempo de entrega < 50 ANo
qty_payment_typesMonto de los pagos1 NNo
ip (deprecated)Solicitar IP < 50 ASi
gift1 - Es un regalo
0 - No es un regalo
1 NNo
reservation_dateFecha del Primer Vuelo del Pedido (en caso de boleto aéreos). < 200 ANo
sequentialSecuencia de pago1 NNo
interésTasa de interés.
Ejemplo: 5,00
< 4 NNo
interest_valueValor absoluto de interés en centavos.
Ejemplo: 1000 (10 reales).
< 20 NNo
shipping_typeID 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 NNo
itemsInformación sobre artículos de compraArrays de objetos json [(Más información)] (# object-items)Si
payerInformación del pagadorjson object [(Más información)] (# payer-object)Si
billing_dataInformación de la facturajson object [(Más información)] (# object-billing_data)Si
shipmentInformación de entregamatriz de objetos json [(Más información)] (# objeto-envío)Si
browserInformación sobre el navegador utilizado para la comprajson object [(Más información)] (# browser-object)Si
travelInformación de tarifas aéreasjson object [(Más información)] (# object-travel)Condicional por institución
passengersInformación del pasajeroArray de objetos json [(Más información)] (#objeto-passengers)Sí, si el artículo es pasaje aéreo
connectionsInformación sobre el navegador utilizado para la compraArray de objetos json [(Más información)] (#objeto-connections)Sí, si el artículo es pasaje aéreo
hotel_reservationsInformación de reserva de hotelmatriz de objetos json [(Más información)] (# object-hotel_reservations)Sí, si la compra es una reserva de hotel
purchase_dataInformación sobre la fecha de comprajson object [(Más información)] (# object-purchase_data)Si
mddInformación relacionada con mdd (datos comerciales). Campo específico de CybersourceArray de objetos json [(Más información)] (# object-mdd)No

Objetos items#

PropiedadesDescripciónFormatoRequerido
idIdentificación única del artículoNSi
skuCódigo de producto del artículo.ACondicional por institución
titleNombre del productoASi
descriptionDescripción del productoANo
quantityCantidad de artículos < 4 NSi
unit_pricePrecio unitario del artículo < 12 NSi
category_idID de categoría de artículo Cada institución de revisión tiene una interpretación diferente.Condicional por instituciónCondicional por institución
category_nameNombre de categoría de producto < 200 ANo
gift1 - Es un regalo
0 - No es un regalo
1 NNo
tax_amountImporte de la tarifaNNo
discount_amountImporte de descuento en centavosNNo
creation_dateFecha de publicación del producto en formato "DD / MM / AAAA".ANNo

Objeto payer#

PropiedadesDescripciónFormatoRequerido
idIdentificación del comprador. Suele ser el CPF.NSi
nameNombre del comprador. Cada institución de revisión tiene una interpretación diferente.Condicional por instituciónCondicional por institución
surnameApellido del comprador < 200 ASi
emailCorreo electrónico del compradorASi
date_createdFecha de creaciónASi
passwordContraseña del compradorCondicional por instituciónCondicional por institución
cityDirección ciudad sin abreviaturas < 150 ASi
address_street_complementComplemento de direcciones sin abreviaturas < 250 ANo
address_countryDirección del país sin abreviaturas < 150 ANo
address_countyBarrio de la dirección sin abreviaturas < 150 ANo
address_street_numberNúmero de dirección < 15 ANo
stateDirección Estado Acrónimo - UF2 ANo
address_street_nameNombre del lugar (sin abreviaturas) < 200 ANo
address_zip_codeDirección código postal < 10 NNo
address_referenceReferencia de dirección (sin abreviaturas) < 250 ANo
legal_documentDocumento de la persona que factura < 100 ANo
phonesContactos telefónicos del compradormatriz de objetos json (Más información)No
addressDirección del compradorjson object (Más información)No

Objeto phones del payer#

PropiedadesDescripciónFormatoObligatorio
ddiCódigo del teléfono3 NNo
dddCódigo de área de teléfono3 NNo
numberNúmero de teléfono9 NNo

Objeto address del payer#

PropiedadesDescripciónFormatoObligatorio
street_nameNombre de la calle. < 200 ASi
street_name2Complemento del nombre de la calle. < 200 ANo
street_numberNúmero de dirección < 15 ASi
apartmentApartamento si lo hubieraNNo
complementComplemento de direcciones sin abreviaturas < 250 ANo
countyBarrio de la dirección sin abreviaturas < 150 ASi
cityDirección ciudad sin abreviaturas < 150 ASi
stateDirección Estado Acrónimo - UF2 ASi
districtDistrito, si lo hayANo
countryPaís de dirección < 150 ANo
zip_codeCódigo postal de la dirección < 10 NSi
referenciaReferencia de dirección sin abreviaturas < 250 ANo
building_numberNúmero de casa. Ejemplo: si es un condominio cerrado, sería el número de casa dentro de este condominio. < 10 ANo

Objeto billing_data#

PropiedadesDescripciónFormatoObligatorio
client_idCódigo de cliente < 50 ASi
person1 - Persona física
2 - Entidad jurídica
1 NSi
cnpj_cpfCPF o CNPJ < 100 ASi
identification_numberRG o registro estatal < 100 ANo
nameNombre del cliente < 500 ASi
birth_dateFecha de nacimiento.Fecha en el formato: aaaa-mm-ddThh: mm: ssSi
emailCorreo electrónico < 150 ANo
genderM - macho
F - hembra
1 ANo
addressDirección de la facturajson object [(Más información)] (# object-address-do-billing_data)No
phonesFactura contactos telefónicosArray de objetos json [(Más información)] (# object-phones-do-billing_data)No
documentsDocumentos de facturaArray de objetos json [(Más información)] (# object-documents-do-billing_data)No

Objeto dirección de billing_data#

PropiedadesDescripciónFormatoObligatorio
street_nameNombre de la calle < 200 ASi
street_name2Complemento del nombre de la calle. < 200 ANo
street_numberNúmero de dirección < 15 ASi
apartmentApartamento si lo hubieraNNo
complementComplemento de direcciones sin abreviaturas < 250 ANo
countyBarrio de la dirección sin abreviaturas < 150 ASi
cityDirección ciudad sin abreviaturas < 150 ASi
stateDirección Estado Acrónimo - UF2 ASi
districtDistrito, si lo hayANo
countryDirección del país sin abreviaturas. < 150 ANo
zip_codeDirección código postal < 10 NSi
referenciaReferencia de dirección sin abreviaturas < 250 ANo
building_numberNúmero de casa. Ejemplo: si es un condominio cerrado, sería el número de casa dentro de este condominio. < 10 ANo

Objeto phones de billing_data#

PropiedadesDescripciónFormatoObligatorio
typeTipo de teléfono:
  • 0 - No definido
  • 1 - Residencial
  • 2 - Comercial
  • 3 - Mensajes
  • 4 - Facturación
  • 5 - Temporal
  • 6 - Celular
1 NSi
dditeléfono IDD3 NNo
dddCódigo de área de teléfono3 NSi
numberNúmero de teléfono9 NSi
extensionExtensión telefónica < 10 ANo

Objeto documents de billing_data#

PropiedadesDescripciónFormatoObligatorio
typeCondicional por institución.ANo
numberNúmero de documentoNSi

Objeto shipment#

PropiedadesDescripciónFormatoObligatorio
idCódigo de cliente < 50 ASi
costValor de envío en centavos < 1024 NNo
typeTipo de persona
1 - Persona física
2 - Persona jurídica
< 1 NSi
legal_document1CPF o CNPJ < 100 ASi
legal_document2RG o registro estatal < 100 ANo
nameNombre del cliente < 500 ASi
surnameApellido del cliente < 500 ASi
birth_dateFecha de nacimiento.Fecha en el formato: aaaa-mm-ddThh: mm: ssNo
emailCorreo electrónico < 150 ANo
genderM - masculino
F - femenino
1 ANo
addressDirección de entregajson object [(Más información)] (# object-address-do-shipping)Condicional por institución
receiver_addressDirección de entregajson object [(Más información)] (# object-address-do-shipping)Condicional por institución
phonesContactos telefónicos de entregaArrays 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

PropiedadesDescripciónFormatoObligatorio
street_nameNombre de la calle. < 200 ASi
street_name2Complemento del nombre de la calle. < 200 ANo
street_numberNúmero de dirección < 15 ASi
apartmentApartamento si lo hubieraNNo
complementComplemento de direcciones sin abreviaturas < 250 ANo
countyBarrio de la dirección sin abreviaturas < 150 ASi
cityDirección ciudad sin abreviaturas < 150 ASi
stateDirección Estado Acrónimo - UF2 ASi
countryPaís de domicilio. < 150 ASi
zip_codeCódigo postal de la dirección. Sólo números. < 10 ASi
building_numberNúmero de casa. Ejemplo: si es un condominio cerrado, sería el número de casa dentro de este condominio. < 10 ANo

Objeto phones de shipment#

PropiedadesDescripciónFormatoObligatorio
typeTipo de teléfono:
  • 0 - no definido
  • 1 - Residencial
  • 2 - Comercial
  • 3 - Mensajes
  • 4 - Facturación
  • 5 - Temporal
  • 6 - Teléfono celular
1 NSi
dditeléfono IDD3 NNo
dddCódigo de área de teléfono3 NSi
numberNúmero de teléfono9 NSi
extensionExtensión telefónica < 10 ANo

Explorador de objetos#

PropiedadesDescripciónFormatoObligtorio
ip_addressDirección IP15 ASi

Objeto travel#

departure_date_time

Objeto passengers#

PropiedadesDescripciónFormatoObligatorio
idId del pasajero < 32 ANo
nameCondicional por institución < 100 ASi
last_nameApellido del pasajero < 100 ACondicional por institución
frequente_flyer_cardMileage Card (fidelidad) < 32 ANo
legal_document_typeTipo de documento de identificación:
  • 1 - CPF
  • 2 - CNPJ
  • 3 - RG
  • 4 - IE
  • 5 - Pasaporte
  • 6 - CTPS
  • 7 - Título del votante
1 NSi
legal_documentNúmero de documento < 50 ASi
birth_dateFecha de nacimiento.Fecha en el formato: aaaa-mm-ddThh: mm: ssNo
emailEmail del pasajero. Debe ser único en el arrays de passengers.Formato: name@domain.comNo
statusEstado de reserva de entradas. Ejemplo: Reservado < 32 ANo
statusClasificación de pasajeros según precio del ticket. < 32 ANo
typeClasificación de pasajeros.
  • ADT: Adult
  • CNN: Child
  • INF: Infant
  • YTH: Youth
  • STU: Student
  • SCR: jubilado
  • MIL: militar
< 32 ANo
unit_pricePrecio unitario del pasaje.Formato (en centavos): 1000 (10 reales)No
phonesContactos telefónicos para pasajerosArrays de objetos json [(Más información)] (#objeto-phones-do-passengers)Si

Objeto phones do passengers#

PropiedadesDescripciónFormatoObligatorio
ddiIDD en el teléfono. Sólo números. Ejemplo: 55 (Brasil)3 NNo
dddCódigo de área del teléfono. Sólo números. Ejemplo: 11 (São Paulo)3 NSi
numberNumero de teléfono. Sólo números. Ejemplo: 123457899 NSi

Objeto ### connections

PropiedadesDescripciónFormatoObligatorio
companyNombre de la aerolínea < 50 ASi
flight_numberNúmero de vuelo6 NSi
flight_dateFecha y hora de salida del primer tramo del vuelo.Condicional por instituciónSi
classClase de asiento < 10 ASi
fromOrigenCondicional por instituciónSi
toDestinoCondicional por instituciónSi
departure_dateFecha de embarque.Fecha en el formato: aaaa-mm-ddThh: mm: ssSi
arrival_dateFecha de aterrizaje.Fecha en el formato: aaaa-mm-ddThh: mm: ssSi

Objeto hotel_reservations#

PropiedadesDescripciónFormatoObligatorio
hotelNombre del hotel < 200 ASi
cityHotel ciudad sin abreviaturas < 150 ASi
stateEstado del hotel sin abreviaturas < 150 ASi
countryPaís del hotel < 150 ASi
reservation_dateFecha para registrarse.Fecha en el formato: aaaa-mm-ddThh: mm: ssSi
reserve_expiration_dateFecha de vencimiento de la reserva.Fecha en el formato: aaaa-mm-ddThh: mm: ssSi
checkin_dateFecha de llegada.Fecha en el formato: aaaa-mm-ddThh: mm: ssSi
checkout_dateFecha de salida.Fecha en el formato: aaaa-mm-ddThh: mm: ssSi

Objeto purchase_data#

PropiedadesDescripciónFormatoObligatorio
last_date_inserted_mailFecha del último cambio de email.Fecha en el formato: yyyy-mm-ddThh:mm:ssNo
last_date_change_passwordFecha del último cambio de contaseña.Fecha en el formato: yyyy-mm-ddThh:mm:ssNo
last_date_change_phoneFecha del último cambio de teléfono.Fecha en el formato: yyyy-mm-ddThh:mm:ssNo
last_date_change_mobile_phoneFecha del último cambio de teléfono mobilFecha en el formato: yyyy-mm-ddThh:mm:ssNo
last_date_inserted_addressFecha del último cambio de dirección.Fecha en el formato: yyyy-mm-ddThh:mm:ssNo
purchase_loggedCompra conectado1 NNo
purchase_logged_with_facebookCompra conectado con Facebook1 NNo

Objeto mdd#

PropiedadesDescripciónFormatoObligatorio
idPuede ir de 1 a 100 definido por el comercio de acuerdo con Cybersource 255 ANo
valueValor de los campos definidos por el comercio en el acuerdo con Cybersource 255 ANo

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.