Evaluacion antifraude

POST 
/antifraude

Evaluacion antifraude

Request

application/json

Body

Ejecutar evaluacion antifraude

monto numberrequired

Possible values: <= 999999999999999

Monto de la transacción

pais string

Possible values: >= 3 characters and <= 3 characters

País la transacción de acuerdo al estándar ISO 3166-1 Alpha-3, con tres letras para representar el país.

moneda string

Possible values: >= 3 characters and <= 3 characters

Identificador de moneda de tres caracteres de acuerdo al estándar ISO 4217

descripcion string

Possible values: <= 250 characters

Descripción breve de la transacción

metodo_pago stringrequired

Possible values: [tarjeta]

Default value: tarjeta

Define el tipo de pago que será usado en la operacion

tarjeta

object

Objeto tarjeta, requerido si metodo_pago = tarjeta

nombre stringrequired

Possible values: >= 3 characters and <= 60 characters

Nombre como aparece en la tarjeta

pan numberrequired

Possible values: >= 14 characters and <= 19 characters

Número de tarjeta

expiracion_mes integerrequired

Possible values: >= 1 and <= 12

Mes de expiración

expiracion_anio integerrequired

Possible values: >= 2 characters and <= 4 characters, >= 2000 and <= 2100

Año de expiración

direccion

object

linea1 string

Possible values: <= 120 characters

Línea de dirección 1

linea2 string

Possible values: <= 120 characters

Línea de dirección 2

linea3 string

Possible values: <= 120 characters

Línea de dirección 3

cp string

Possible values: >= 3 characters and <= 10 characters

Código postal

telefono

object

tipo string

Possible values: [no_definido, movil, casa, oficina, facturacion, mensajeria, temporal]

De acuerdo al catálogo tipo teléfono

codigo_pais string

Codigo telefónico de un país

codigo_area string

Codigo telefónico de área

prefijo string

Valor opcional, prefijo utilizado por algunos países

numero number

Teléfono del cliente

extension number

Extensión

municipio string

Possible values: <= 60 characters

Municipio o delegación

ciudad string

Possible values: <= 60 characters

Ciudad

estado string

Possible values: >= 3 characters and <= 3 characters

Identificador de estado de tres caracteres de acuerdo al estándar ISO 3166-2

pais string

Possible values: >= 3 characters and <= 3 characters

Identificador de país de tres caracteres de acuerdo al estándar ISO 3166-1

referencia_1 string

Possible values: <= 120 characters

Referencia adicional, ejemplo: nombre de entre calle 1

referencia_2 string

Possible values: <= 120 characters

Referencia adicional, ejemplo: nombre de entre calle 2

longitud number

Possible values: >= -90 and <= 90

Coordenadas de longitud de localización del domicilio

latitud number

Possible values: >= -90 and <= 90

Coordenadas de latitud de localización del domicilio

pedido

object

required

Objeto Pedido

id_externo string

Possible values: >= 5 characters and <= 48 characters

Identificador de orden del comercio

creacion date-time

Fecha de creación del objeto

direccion_envio

object

linea1 string

Possible values: <= 120 characters

Línea de dirección 1

linea2 string

Possible values: <= 120 characters

Línea de dirección 2

linea3 string

Possible values: <= 120 characters

Línea de dirección 3

cp string

Possible values: >= 3 characters and <= 10 characters

Código postal

telefono

object

tipo string

Possible values: [no_definido, movil, casa, oficina, facturacion, mensajeria, temporal]

De acuerdo al catálogo tipo teléfono

codigo_pais string

Codigo telefónico de un país

codigo_area string

Codigo telefónico de área

prefijo string

Valor opcional, prefijo utilizado por algunos países

numero number

Teléfono del cliente

extension number

Extensión

municipio string

Possible values: <= 60 characters

Municipio o delegación

ciudad string

Possible values: <= 60 characters

Ciudad

estado string

Possible values: >= 3 characters and <= 3 characters

Identificador de estado de tres caracteres de acuerdo al estándar ISO 3166-2

pais string

Possible values: >= 3 characters and <= 3 characters

Identificador de país de tres caracteres de acuerdo al estándar ISO 3166-1

referencia_1 string

Possible values: <= 120 characters

Referencia adicional, ejemplo: nombre de entre calle 1

referencia_2 string

Possible values: <= 120 characters

Referencia adicional, ejemplo: nombre de entre calle 2

longitud number

Possible values: >= -90 and <= 90

Coordenadas de longitud de localización del domicilio

latitud number

Possible values: >= -90 and <= 90

Coordenadas de latitud de localización del domicilio

nombre string

Nombre o nombres del cliente

apellido_paterno string

Apellido paterno del cliente

apellido_materno string

Apellido materno del cliente

peso number

Peso total del pedido (en Kg.)

articulos

object[]

Arreglo de Objetos Articulo

Array [

id_pedido string

Identificador de orden del comercio

nombre_producto string

Nombre de producto

descripcion_producto string

Descripción del producto

sku string

Id único de producto en el comercio, código interno (SKU: stock keeping unit)

ean_upc string

Id de producto de acuerdo a códigos internacionales (UPC: universal product code, EAN: European article number, GS1/GTIN, otros)

tipo_producto string

Possible values: [digital, servicio, electronico, software, suscripcion, cupon, tarjeta_regalo, moda, otro]

De acuerdo a referencia de Catálogo Tipo de Producto

cantidad integer

Número de piezas del mismo producto

precio_unitario number

Precio unitario del producto

precio_total number

Precio total incluyendo todas las piezas

otros string

Possible values: <= 255 characters

Campo para detalles adicionales del producto disponible para el comercio, máximo 255 caracteres

es_digital boolean

Indica si el producto es digital y su entrega puede ser inmediata (descarga / envío de código / etc…)

]

total_articulos integer

Total de artículos en pedido

fecha_creacion date-time

Fecha de levantamiento de pedido en el Comercio

fecha_entrega date-time

Fecha estimada de entrega

empresa_envio string

Possible values: [noventamin, correosmex, dhl, estafeta, fedex, aeroflash, paquetexpress, redpack, senda, ups, propia, otro]

numero_guia string

Possible values: <= 250 characters

Número de guía de pedido

es_regalo boolean

Indicará si el pedido es considerado un regalo

monto_articulos number

Monto total con impuestos del costo de articulos

monto_envio number

Monto total sin impuestos del envío

total_monto number

Monto total con impuestos del pedido

device_fingerprint string

Id de dispositivo de cliente

ip_cliente ipv4

Ip del cliente o comprador

datos_comercio

object

key number

Possible values: >= 1 and <= 99

Key de campo personalizado

value string

Possible values: non-empty and <= 250 characters

Valor de campo personalizado

cliente

object

required

id string

Possible values: <= 64 characters

Id de cliente previamente registrado en T1pagos, si se incluye el id, podrán omitirse todos los demás datos del objeto cliente

id_externo stringrequired

Possible values: <= 64 characters

Identificador único de cliente en plataforma del comercio

creacion_externa date-time

Fecha y hora de creación del usuario en el comercio

nombre string

Possible values: >= 3 characters and <= 30 characters

Nombre o nombres del cliente

apellido_paterno string

Possible values: >= 3 characters and <= 30 characters

Apellido paterno del cliente

apellido_materno string

Possible values: >= 3 characters and <= 30 characters

Apellido materno del cliente

email emailrequired

Possible values: <= 250 characters

Correo electrónico del cliente

telefono

object

tipo string

Possible values: [no_definido, movil, casa, oficina, facturacion, mensajeria, temporal]

De acuerdo al catálogo tipo teléfono

codigo_pais string

Codigo telefónico de un país

codigo_area string

Codigo telefónico de área

prefijo string

Valor opcional, prefijo utilizado por algunos países

numero number

Teléfono del cliente

extension number

Extensión

direccion

object

linea1 string

Possible values: <= 120 characters

Línea de dirección 1

linea2 string

Possible values: <= 120 characters

Línea de dirección 2

linea3 string

Possible values: <= 120 characters

Línea de dirección 3

cp string

Possible values: >= 3 characters and <= 10 characters

Código postal

telefono

object

tipo string

Possible values: [no_definido, movil, casa, oficina, facturacion, mensajeria, temporal]

De acuerdo al catálogo tipo teléfono

codigo_pais string

Codigo telefónico de un país

codigo_area string

Codigo telefónico de área

prefijo string

Valor opcional, prefijo utilizado por algunos países

numero number

Teléfono del cliente

extension number

Extensión

municipio string

Possible values: <= 60 characters

Municipio o delegación

ciudad string

Possible values: <= 60 characters

Ciudad

estado string

Possible values: >= 3 characters and <= 3 characters

Identificador de estado de tres caracteres de acuerdo al estándar ISO 3166-2

pais string

Possible values: >= 3 characters and <= 3 characters

Identificador de país de tres caracteres de acuerdo al estándar ISO 3166-1

referencia_1 string

Possible values: <= 120 characters

Referencia adicional, ejemplo: nombre de entre calle 1

referencia_2 string

Possible values: <= 120 characters

Referencia adicional, ejemplo: nombre de entre calle 2

longitud number

Possible values: >= -90 and <= 90

Coordenadas de longitud de localización del domicilio

latitud number

Possible values: >= -90 and <= 90

Coordenadas de latitud de localización del domicilio

PlanPagos

object

Objeto Plan de Pagos

plan string

Possible values: [normal, msi, mci, diferido, diferido_msi, diferido_mci]

Clave del plan a aplicar de Catálgo Tipo de Plan de Pago

parcialidades integer

Possible values: <= 24, [3, 6, 9, 12, 15, 18, 24]

Número de parcialidades a dividir el pago si aplica

diferido integer

Número de meses de diferimiento para iniciar el/los pago/s

redime_puntos boolean

Redimir puntos en compra con tarjetas participantes (consultar antes de enviar)

Responses

200

Evaluacion exitosa

application/json

Schema

Schema

status string

Possible values: [success, fail, error]

Estatus de la petición

http_code integer

Possible values: [200, 400, 401, 404, 500]

Código http de respuesta en el header

datetime date-time

Fecha y hora de la ejecucion

timestamp integer

Tiempo Unix o POSIX

data

object

evaluacion

object

id string

Identificador de la transacción

orden_id string

Identificador del orden del comercio

estatus string

Possible values: [aprobada-antifraude, revisar-antifraude, rechazada-antifraude]

Reusltado de la evaluacion

decision string

Possible values: [aceptar, revisar, rechazar, sin_resultados, sin_respuesta, error_en_peticion]

Decision de la evaluacion

procesador string

Possible values: [cybersource, claroscore]

Procesador que tomo la decision de la evaluacion

descripcion string

Descripción del resultado de la evaluacion.

score integer

Calificacion final de la evaluación.

codigo integer

Código de respuesta procesador antifraude.

profile string

Perfil asiganado a la evaluación.

resultados

object[]

Arreglo de Objetos resultado

Array [

score integer

Calificacion final de la evaluación.

codigo integer

Código de respuesta procesador antifraude.

profile string

Perfil asiganado a la evaluación.

resultado string

Possible values: [verde, amarillo, rojo, azul, negro]

Resultado de la evaluacion

monitor boolean

Evaluación en modo monitor

procesador string

Possible values: [cybersource, claroscore]

Procesador que ejecuto la evaluacion

]

Example (from schema)

{
  "status": "success",
  "http_code": 200,
  "datetime": "2024-05-22T21:56:52.964Z",
  "timestamp": 0,
  "data": {
    "evaluacion": {
      "id": "string",
      "orden_id": "string",
      "estatus": "aprobada-antifraude",
      "decision": "aceptar",
      "procesador": "cybersource",
      "descripcion": "string",
      "score": 0,
      "codigo": 0,
      "profile": "string",
      "resultados": [
        {
          "score": 0,
          "codigo": 0,
          "profile": "string",
          "resultado": "verde",
          "monitor": false,
          "procesador": "cybersource"
        }
      ]
    }
  }
}

400

Error en petición

application/json

Schema

Schema

status string

Possible values: [error, fail]

Estatus de la petición

error

object

code integer

type string

message string
http_code integer

Código http de respuesta en el header

datetime date-time

Fecha y hora de creación.

timestamp integer

Tiempo Unix o POSIX

data object

Datos del error obtenido, sólo estará presente en errores HTTP 400

Example (from schema)

{
  "status": "error",
  "error": {
    "code": 0,
    "type": "string",
    "message": "string"
  },
  "http_code": 0,
  "datetime": "2024-05-22T21:56:52.965Z",
  "timestamp": 0,
  "data": {}
}

401

No autorizado

application/json

Schema

Schema

status string

Possible values: [error, fail]

Estatus de la petición

error

object

code integer

type string

message string
http_code integer

Código http de respuesta en el header

datetime date-time

Fecha y hora de creación.

timestamp integer

Tiempo Unix o POSIX

data object

Datos del error obtenido, sólo estará presente en errores HTTP 400

Example (from schema)

{
  "status": "error",
  "error": {
    "code": 0,
    "type": "string",
    "message": "string"
  },
  "http_code": 0,
  "datetime": "2024-05-22T21:56:52.965Z",
  "timestamp": 0,
  "data": {}
}

404

No se ha encontrado el recurso solicitado

application/json

Schema

Schema

status string

Possible values: [error, fail]

Estatus de la petición

error

object

code integer

type string

message string
http_code integer

Código http de respuesta en el header

datetime date-time

Fecha y hora de creación.

timestamp integer

Tiempo Unix o POSIX

data object

Datos del error obtenido, sólo estará presente en errores HTTP 400

Example (from schema)

{
  "status": "error",
  "error": {
    "code": 0,
    "type": "string",
    "message": "string"
  },
  "http_code": 0,
  "datetime": "2024-05-22T21:56:52.965Z",
  "timestamp": 0,
  "data": {}
}

4XX

Error en petición

application/json

Schema

Schema

status string

Possible values: [error, fail]

Estatus de la petición

error

object

code integer

type string

message string
http_code integer

Código http de respuesta en el header

datetime date-time

Fecha y hora de creación.

timestamp integer

Tiempo Unix o POSIX

data object

Datos del error obtenido, sólo estará presente en errores HTTP 400

Example (from schema)

{
  "status": "error",
  "error": {
    "code": 0,
    "type": "string",
    "message": "string"
  },
  "http_code": 0,
  "datetime": "2024-05-22T21:56:52.965Z",
  "timestamp": 0,
  "data": {}
}

5XX

Error interno

application/json

Schema

Schema

status string

Possible values: [error, fail]

Estatus de la petición

error

object

code integer

type string

message string
http_code integer

Código http de respuesta en el header

datetime date-time

Fecha y hora de creación.

timestamp integer

Tiempo Unix o POSIX

data object

Datos del error obtenido, sólo estará presente en errores HTTP 400

Example (from schema)

{
  "status": "error",
  "error": {
    "code": 0,
    "type": "string",
    "message": "string"
  },
  "http_code": 0,
  "datetime": "2024-05-22T21:56:52.965Z",
  "timestamp": 0,
  "data": {}
}

Loading...