Skip to main content
POST /analyze acepta un objeto plano con los datos de la transacción. Cuatro campos son obligatorios; el resto son opcionales y cada uno habilita una categoría de señal adicional.

​
Campos obligatorios

El nombre canónico que debes enviar es payment_method. paymentInstrumentType es el mismo concepto con otro nombre en el JSON, no un segundo campo. Valores y rieles: Métodos de pago.

​
Campos opcionales

auth_response_code también se acepta como response_code (mismo campo).
device_id, ip_address y user_id, además de habilitar sus categorías directas, son también la base sobre la que se calculan señales de velocidad a través de transacciones — no hay un campo único que active esa categoría por sí solo.

​
Otros campos aceptados

  • created_at (opcional, ISO 8601): marca de tiempo de la transacción. Si no la envías, se usa el momento de la petición.
  • is_chargeback, is_friendly_fraud: etiquetas de resultado histórico, útiles para reentrenamiento — no son señales de scoring.
  • extra_fields, tags: no participan en el scoring; se guardan como información adicional de la transacción. No uses tags para simular el modo sandbox: eso es la ruta /analyze/sandbox.

​
Más campos, más cobertura

No hay un mínimo de campos opcionales requerido — el motor scorea con lo que reciba. Pero mientras más campos envíes, más categorías de señal se evalúan. No existe una relación fija entre cuántos campos envías y el resultado: dos transacciones con la misma cobertura de campos pueden terminar en decisiones distintas. Siguiente paso: Paso a producción.