Address Verification Service (AVS)
Verifica la dirección de facturación de tus clientes en compras online y mantén la posibilidad de reclamar contracargos por fraude.
Introducción
En las compras online, el comercio y el adquirente necesitan señales para evaluar si una transacción es legítima.
El Address Verification Service (AVS) agrega una de ellas: compara la dirección de facturación que ingresa tu cliente al comprar con la dirección que tienes registrada para él. Nosotros te informamos el resultado durante la autorización, para que lo uses como un dato más al evaluar el riesgo.
Además, tener AVS te ayuda a poder reclamar un contracargo cuando tu cliente desconoce una compra online por fraude.
Alcance
AVS está vigente para los programas Visa de Latinoamérica desde el 24 de octubre de 2026. Si tienes dudas sobre si aplica en un país donde operas, consúltanos.
Funcionamiento
- Tu cliente ingresa su dirección de facturación al comprar en un comercio online.
- El adquirente envía esa dirección en la solicitud de autorización.
- Comparamos la dirección recibida con la dirección registrada de tu cliente en la API de Usuarios, o tu sistema la compara si elegiste la validación propia.
- Informamos el resultado de la verificación durante la autorización, como un campo adicional para evaluar el riesgo.
- Decides si el resultado influye en la aprobación mediante tus reglas de autorización.
Modalidades de verificación
Tienes dos alternativas para realizar la verificación.
| Opción 1: Validación a través de Pomelo | Opción 2: Validación desde tu sistema | |
|---|---|---|
| Quién verifica | Nosotros, con la dirección registrada en nuestra plataforma mediante la API de Usuarios. | Tú, con la dirección registrada en tu sistema. |
| Integración técnica | No requiere. | Requiere adaptar tu integración para procesar la información de AVS. |
| Cómo se activa | Aplicamos esta modalidad automáticamente si no solicitas otra. | Creas un ticket desde el Dashboard para solicitarla y coordinar la integración. |
| Core de crédito o débito de Pomelo | Es la modalidad requerida. | No disponible por el momento. |
Validación desde tu sistema
Si eliges la Opción 2, te enviamos los datos de AVS en la solicitud de autorización y tú devuelves el resultado en la respuesta. Consulta el detalle completo en la API de Autorizar.
Request: datos que recibes
Si tienes habilitada la validación AVS, te enviamos el objeto avs_cardholder_data solo cuando la transacción incluye esos datos.
| Campo | Descripción | Ejemplo |
|---|---|---|
| avs_cardholder_data.zip_code | Código postal de facturación que ingresó tu cliente. | 12345 |
| avs_cardholder_data.street_address | Dirección de facturación que ingresó tu cliente. | 1 Main St |
Response: resultado que devuelves
En tu respuesta puedes incluir el campo avs_result. Es informativo y no afecta la aprobación de la transacción.
| Valor | Descripción |
|---|---|
FULL_MATCH | Coinciden el código postal y la dirección. |
PARTIAL_MATCH_STREET_ADDRESS | Coincide la dirección, pero no el código postal. |
PARTIAL_MATCH_ZIP_CODE | Coincide el código postal, pero no la dirección. |
NO_MATCH | No coincide ninguno de los dos datos. |
Mantén actualizadas las direcciones de tus clientes
Independientemente de la modalidad que elijas, necesitas mantener actualizadas las direcciones de tus clientes.
Si la dirección registrada no coincide con la que se ingresó en la compra, AVS puede devolver un resultado de no coincidencia, incluso cuando la operación es legítima. Este resultado no genera un rechazo automático, pero el emisor, el adquirente o el comercio pueden usarlo para evaluar el riesgo y decidir según sus propias reglas.
Te recomendamos revisar tus procesos de actualización de datos y mantener las direcciones al día con el endpoint Modificar usuario.
Impacto en la gestión de contracargos
Desde el 24 de octubre de 2026, si el adquirente solicita la verificación de dirección y recibe una respuesta U, un contracargo por fraude asociado a esa transacción puede considerarse inválido, según las condiciones aplicables de Visa. Cumplir con los requisitos de AVS reduce ese riesgo.
Cómo solicitar la validación desde tu sistema
- Ingresa al Dashboard.
- Crea un ticket solicitando la modalidad de validación desde tu sistema.
- Coordinamos contigo la integración.
- Adapta tu integración según la API de Autorizar.
Preguntas frecuentes
¿AVS rechaza transacciones automáticamente?
No. El resultado es una señal adicional de riesgo. Solo influye en la aprobación si lo incorporas a tus reglas de autorización.
¿Tengo que hacer una integración para cumplir con el requisito?
No. Si no solicitas otra modalidad, realizamos la verificación por defecto, sin integración adicional. Solo necesitas mantener actualizadas las direcciones de tus clientes.
¿Puedo hacer la validación desde mi sistema si uso el core de Pomelo?
No. Si usas nuestro Core, validaremos nosotros.
¿Qué pasa si la dirección de mi cliente no coincide con la que ingresó en la compra?
AVS puede devolver un resultado de no coincidencia, incluso si la operación es legítima. No genera un rechazo automático, pero el emisor, el adquirente o el comercio pueden usarlo para evaluar el riesgo.
¿Cómo actualizo las direcciones de mis clientes?
Usa el endpoint Modificar usuario.
¿Qué pasa con los contracargos si el adquirente recibe una respuesta U?
Un contracargo por fraude asociado a esa transacción puede considerarse inválido, según las condiciones aplicables de Visa. Para reducir ese riesgo, validamos por defecto la dirección que tengas cargada.
¿Aplica a todos los países?
No. AVS aplica a los programas Visa de Latinoamérica, pero no es obligatorio en todos los países. Si tienes dudas sobre tu programa, consúltanos.
¿Cómo cambio de modalidad?
Crea un ticket desde el Dashboard y coordinamos el cambio contigo.
¿Aplica a Mastercard?
Todavía no. Mastercard activará AVS el 17 de abril de 2027 y la integración será la misma que describimos en esta guía.