Saltar al contenido principal
Cuando se autoriza un pago con tarjeta, el emisor puede devolver el resultado de varias verificaciones que la red ejecutó sobre los datos de la tarjeta proporcionados por el cliente, principalmente AVS (Address Verification Service) y la coincidencia del CVV / CVC. Yuno te devuelve esos resultados en cada transacción con tarjeta para que puedas usarlos en tu propia lógica de riesgo, conciliación o reintentos. Esta guía cubre:
  • Qué significa cada resultado de verificación
  • Dónde encontrarlos en la respuesta de la API y en los webhooks
  • Cómo interpretar los códigos
  • Cómo usarlos en tu flujo de decisión

Qué se verifica

Las cuatro verificaciones dependen del emisor: Yuno no las calcula, reenvía exactamente lo que devuelve el adquirente o la red de tarjetas.

Dónde encontrarlos en la respuesta

El bloque se encuentra en el detalle de la tarjeta del método de pago, y se duplica en cada transacción que ejecutó una verificación:
Aparece en la respuesta de:
  • POST /v1/payments: Crear pago
  • GET /v1/payments/{id}: Consultar pago
  • POST /v1/payments/{id}/capture, /refund, /cancel, etc.
También se incluye en los eventos de webhook de pago (payment.created, payment.updated, …), dentro de la misma ruta payment_method.detail.card.

Ejemplo de respuesta (extracto)

Si no se realizó ninguna de las verificaciones, el objeto verification_services completo se omite de la respuesta.

Valores de resultado

Yuno normaliza el resultado de cada verificación devuelto por el emisor o el adquirente en uno de cuatro valores canónicos. Cada uno de los cuatro campos usa el mismo enum:

Cómo usar estos resultados

Los resultados de AVS y CVV no son decisiones de autorización: la transacción puede ser aprobada aunque las verificaciones fallen. Son señales orientativas que puedes incorporar a tu propia estrategia de riesgo. Una matriz de decisión simple que usan muchos comercios: Como la cobertura de la verificación varía según el emisor y la región, cualquier lógica de decisión que construyas encima debería:
  1. Tomar por defecto la decisión de autorización. Una transacción SUCCEEDED debería enviarse, a menos que tu política de riesgo indique lo contrario.
  2. Combinar señales. Combina CVV / AVS con fraud_screening, el resultado de three_d_secure y provider_data.iso8583_response_code.
  3. Tolerar UNAVAILABLE y UNCHECKED. Muchas tarjetas en Latinoamérica y EMEA no ejecutan AVS en absoluto.

Envío de datos de verificación en la solicitud

También puedes enviar verification_services a Yuno en la solicitud de creación del pago, por ejemplo, cuando retransmites resultados de autenticación de un sistema de registro. Los mismos cuatro campos se aceptan en:
Cuando se proporcionan en la solicitud, Yuno reenvía los valores al proveedor downstream cuando es compatible.