- 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:POST /v1/payments: Crear pagoGET /v1/payments/{id}: Consultar pagoPOST /v1/payments/{id}/capture,/refund,/cancel, etc.
payment.created, payment.updated, …), dentro de la misma ruta payment_method.detail.card.
Ejemplo de respuesta (extracto)
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:
- Tomar por defecto la decisión de autorización. Una transacción
SUCCEEDEDdebería enviarse, a menos que tu política de riesgo indique lo contrario. - Combinar señales. Combina CVV / AVS con
fraud_screening, el resultado dethree_d_secureyprovider_data.iso8583_response_code. - Tolerar
UNAVAILABLEyUNCHECKED. 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 enviarverification_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: