Sistema de Verificación de Direcciones (AVS) | Adyen Docs

El Sistema de Verificación de Direcciones (AVS) es un servicio que verifica si una dirección de facturación coincide con la dirección del titular de una tarjeta de crédito. El AVS es una medida de prevención del fraude ampliamente utilizada para las transacciones con tarjeta no presente (CNP), como los pagos en línea o los pagos de pedidos por correo/teléfono (MOTO) en los puntos de venta.
El AVS le permite comprobar si el comprador que realiza el pedido es la misma persona que el titular de la tarjeta de crédito, lo que es más probable si los datos de la dirección de facturación coinciden.

¿Cómo funciona el AVS?

Cuando un comprador paga una transacción, usted puede recopilar los datos de su dirección de facturación. A continuación, envía esos datos en el objeto billingAddress en la solicitud de autorización de pago. Cuando hayas habilitado el AVS, el sistema comprobará si esos datos de la dirección de facturación coinciden con la información del titular de la tarjeta de crédito del banco emisor en el archivo y en qué medida.

La respuesta a la solicitud de pago contendrá un código de respuesta Adyen AVS que se mapea a un código de respuesta AVS en bruto. Puede ver el mapeo en la tabla de mapeo.

Cuando la comprobación AVS da como resultado una falta de coincidencia, puede activar una regla de riesgo. Puede utilizar la regla de riesgo estándar La dirección de facturación no coincide con la dirección del titular de la tarjeta, o puede crear una regla de riesgo personalizada. En función de la respuesta de AVS, puede decidir qué hacer con el pago: puede aceptarlo, hacer una excepción o cancelar una transacción.

AVS es compatible con los pagos con tarjeta con Visa, MasterCard, Discover o American Express. Los emisores de tarjetas de crédito de Estados Unidos, Canadá y Reino Unido deben admitir las solicitudes de verificación de AVS cuando las envíe, sin embargo, el uso de AVS no es obligatorio para usted como comerciante.

Habilite y pruebe AVS

Para poder activar AVS y las reglas de riesgo de AVS, configure sus solicitudes de autorización de pago para incluir los detalles de la dirección de facturación. La forma de hacerlo depende de su integración. Siga las instrucciones siguientes que sean relevantes para usted.

AVS en las solicitudes de API

Recoge la dirección de facturación del comprador.

API de pago: Asegúrate de recoger los datos de la dirección de facturación del comprador para incluirlos en la petición /payments. Si está utilizando una integración del lado del cliente para la Web, el Componente de la Tarjeta y la Caída de la Web puede configurarse para recopilar la dirección de facturación de su comprador.
Integración clásica: Asegúrese de recopilar los datos de la dirección de facturación del comprador para incluirlos en la solicitud de /autorización.

Envíe la información de la dirección de facturación recopilada en la solicitud de autorización de pago. Proporcione la dirección completa del comprador utilizando el elemento hijo billingAddress:

{ "billingAddress": { "country":"US", "city":"SF", "street":"Example street", "houseNumberOrName":"40", "stateOrProvince":"CA", "postalCode":"91351" }}

<billingAddress xmlns="http://payment.services.adyen.com"> <country xmlns="http://common.services.adyen.com">US</country> <city xmlns="http://common.services.adyen.com">SF</city> <street xmlns="http://common.services.adyen.com">Example street</street> <houseNumberOrName xmlns="http://common.services.adyen.com">40</houseNumberOrName> <stateOrProvince xmlns="http://common.services.adyen.com">CA</stateOrProvince> <postalCode xmlns="http://common.services.adyen.com">91351</postalCode> </billingAddress>

billingAddress.country=US&billingAddress.street=Example+street&billingAddress.houseNumberOrName=40&billingAddress.postalCode=91351&billingAddress.stateOrProvince=CA&billingAddress.city=SF

Cuando envíe el objeto billingAddress para AVS, se requieren los siguientes elementos hijos:

El nombre de la ciudad.

El nombre de la calle.

El número o nombre de la casa.

Campo	Tipo	Descripción
`country`	String	El formato del valor de `country` tiene que cumplir la norma ISO 3166-1 alfa-2. Un código de país no válido provoca el rechazo de la transacción/solicitud. Puede consultar los códigos de país en el sitio web de la ISO.
`city`	Cadena
`street`	Cadena
`houseNumberOrName`	Cadena
`postalCode`	Cadena	Un máximo de cinco dígitos para una dirección en Estados Unidos, o un máximo de diez caracteres para una dirección en el resto de países.
`stateOrProvince`	Cadena	Requerido para los compradores de Reino Unido, Estados Unidos o Canadá. Proporcionar el elemento hijo `stateOrProvince` como se define en la norma ISO 3166-2. Por ejemplo, CA en EE.UU. u ON para Canadá. AVS no valida `stateOrProvince`.

Pasa las líneas de dirección, como el número de apartamento o unidad, como parte de street.
Si no conoce el país o no está recogiendo el país del comprador, proporcione country como ZZ.

Para tener derecho a mejores tasas de intercambio envíe la dirección de facturación y el código postal para las transacciones con tarjeta no presente. Esto no está garantizado, contacta con el equipo de soporte para saber más.

AVS para páginas de pago alojadas (HPP)
Para activar AVS para una piel HPP:
Vaya al Área de clientes > Cuenta > Pieles.
Busque y seleccione la que desea editar.
En Opciones de la piel, seleccione la casilla Campos de dirección de facturación (AVS).

La configuración de AVS es específica de cada skin. Debe activarlo para cada skin para aplicar AVS.

Para obtener una lista de parámetros necesarios para esta llamada, consulte Dirección de facturación HPP y campos AVS.

Puede elegir que los HPP rellenen previamente la información de la dirección de facturación de su propio sistema, como se muestra a continuación:

Prueba de los resultados de AVS

Para probar la respuesta de su sistema al recibir una avsResult:

Utilice nuestras tarjetas de prueba de AVS y direcciones de facturación proporcionadas o cree sus propias tarjetas de prueba.
Incluya y defina todos los parámetros requeridos de billingAddress.
Configure el valor de street a Resultado de AVS de prueba.
Configure el valor de houseNumberOrName al código de respuesta de AVS que desea probar desde la tabla de asignación. Esta tabla muestra los códigos de respuesta AVS devueltos por Adyen, que se asignan a los códigos de respuesta AVS sin procesar de los adquirentes.

Utilizar reglas de riesgo AVS

Puede utilizar y configurar la regla de riesgo de consistencia estándar La dirección de facturación no coincide con la dirección del titular de la tarjeta.

Alternativamente, puede configurar reglas de riesgo personalizadas utilizando las respuestas AVS. En su regla personalizada, para el campo avsResponseCode, puede utilizar los valores de respuesta de Adyen de la tabla de mapeo para definir el comportamiento de la regla de riesgo.

Respuestas AVS y mapeo

Diferentes marcas y redes de tarjetas tienen códigos de respuesta AVS específicos. Muchos de ellos están mapeados con los códigos de respuesta que recibes de Adyen. También tenemos una serie de códigos de respuesta AVS de Adyen para acomodar a los adquirentes que envían respuestas AVS en bruto ligeramente diferentes.

Para el mapeo de los resultados AVS para las transacciones MOTO en el punto de venta con AVS, consulte las respuestas AVS para el punto de venta.

Si prefiere recibir el código de respuesta real de la tarjeta o de la red, puede activarlos en su Área de Cliente:

Entre en su Área de Cliente.
Vaya a Cuenta > URLs de la API > Configuración de datos adicionales.
Seleccione las casillas de verificación Resultado del adquirente y Resultado del adquirente sin procesar.

Si tiene algún problema, póngase en contacto con el equipo de asistencia.

–

Código de respuesta Adyen de AVS Descripción Código de respuesta Raw de AVS código	Aplica a	Detalles
0	Desconocido.	–	Todos los emisores	Adyen no recibió respuesta del banco emisor. Puede permitir o no permitir transacciones con un resultado AVS desconocido a través de las opciones de la regla de consistencia AVS.
1	La dirección coincide, pero el código postal no coincide.	A	Varía según el esquema de la tarjeta	Visa y MasterCard: La dirección coincide, el código postal no. American Express: La dirección sólo coincide.
2	Ni el código postal ni la dirección coinciden.	N	Visa, MasterCard, Discover, American Express	Ni la dirección ni el código postal coinciden.
3	AVS no disponible.	R, S, U	Visa, MasterCard, Discover, American Express	R: Sistema no disponible o agotado. Discover: No aplicable. S: AVS actualmente no soportado. U: No hay datos del emisor/Plataforma de Autorización. Discover: El sistema no está disponible o se ha agotado el tiempo.
4	AVS no se admite para este tipo de tarjeta.	Cualquier tarjeta de crédito excepto Visa, MasterCard, Discover, American Express	–
5	No se proporcionan datos AVS.	–		Visa, MasterCard, Discover, American Express	–
6	El código postal coincide, pero la dirección no.	T, W, Z	Varía según el esquema de la tarjeta	T: Sólo Discover: para direcciones de EE.UU., el código postal de nueve dígitos coincide, la dirección no. W: Sólo MasterCard: Para direcciones de EE.UU., el código postal de nueve dígitos coincide, la dirección no; para direcciones fuera de EE.UU., el código postal coincide, la dirección no. Z: Visa: para direcciones de EE.UU., el código postal de cinco o nueve dígitos coincide, la dirección no. Z: MasterCard y Discover: para direcciones de EE.UU., el código postal de cinco dígitos coincide, la dirección no. Z: American Express: sólo coincide el código postal.
7	Tanto el código postal como la dirección coinciden.	A, D, F, M, X, Y	Varía según el esquema de la tarjeta	A: Discover: Dirección y código postal de cinco dígitos coincidentes. D: Sólo Visa. Coincidencia de dirección y código postal. F: Sólo Visa. La dirección y el código postal coinciden. Sólo se aplica al Reino Unido. M: Sólo Visa. La dirección y el código postal coinciden. X: Visa y American Express: no se aplica. X: MasterCard: Para las direcciones de EE.UU., todos los dígitos del código postal coinciden; para las direcciones fuera de EE.UU., el código postal y la dirección coinciden. X: Discover: Para las direcciones de EE.UU., el código postal de nueve dígitos y la dirección coinciden. Y: Visa: Para direcciones de EE.UU., coincidencia de código postal de cinco dígitos o de nueve dígitos. Y: MasterCard: Para direcciones de EE.UU., coincide el código postal de cinco dígitos y la dirección. S: Discover: Sólo coincide la dirección. Y: American Express: El código postal y la dirección coinciden.
8	Dirección no comprobada, código postal desconocido.	–	Visa, MasterCard, Discover, American Express	Sólo se utiliza para adquirentes que no utilizan una respuesta bruta AVS estándar.
	La dirección coincide, código postal desconocido.	–	Visa, MasterCard, Discover, American Express	Sólo se utiliza para las entidades adquirentes que no utilizan una respuesta bruta AVS estándar.
	La dirección no coincide, código postal desconocido.	Visa, MasterCard, Discover, American Express	Sólo se utiliza para adquirentes que no utilizan una respuesta bruta AVS estándar.
11	Código postal no comprobado, dirección desconocida.	–	Visa, MasterCard, Discover, American Express	Sólo se utiliza para adquirentes que no utilizan una respuesta bruta AVS estándar.
	La dirección coincide, el código postal no se comprueba.	B	Visa	La dirección coincide. Código postal no verificado por formatos incompatibles. (El adquirente envió tanto la dirección como el código postal.)
13	La dirección no coincide, el código postal no se verifica.	Visa, MasterCard, Discover, American Express	Sólo se utiliza para adquirentes que no utilizan una respuesta bruta AVS estándar.
14	Código postal coincide, dirección desconocida.	–		Visa, MasterCard, Discover, American Express	Sólo se utiliza para los adquirentes que no utilizan una respuesta bruta AVS estándar.
	Código postal coincide, dirección no verificada.	Pisa	Código postal coincide. Dirección no verificada por formatos incompatibles. (El adquirente envió tanto la dirección de la calle como el código postal.)
16	El código postal no coincide, dirección desconocida.	Visa, MasterCard, Discover, American Express	Sólo se utiliza para adquirentes que no utilizan una respuesta bruta AVS estándar.
17	Código postal no coincide, dirección no comprobada.	–	Visa, MasterCard, Discover, American Express	Sólo se utiliza para adquirentes que no utilizan una respuesta bruta AVS estándar.
	No se verificaron ni el código postal ni la dirección.	C, G, I	Visa	C: La dirección y el código postal no se verificaron debido a formatos incompatibles. (El adquirente envió tanto la dirección como el código postal.) G: Participante no perteneciente a AVS fuera de EE.UU.; dirección no verificada para la transacción internacional. I: Información de la dirección no verificada para la transacción internacional.
19	Nombre y código postal coinciden.	–		Visa, MasterCard, Discover, American Express	Sólo se utiliza para los adquirentes que no utilizan una respuesta bruta AVS estándar.
20	Comparaciones de nombre, dirección y código postal.	Visa, MasterCard, Discover, American Express	Sólo se utiliza para los adquirentes que no utilizan una respuesta bruta AVS estándar.
21	Comparaciones de nombre y dirección.	–		Visa, MasterCard, Discover, American Express	Sólo se utiliza para adquirentes que no utilizan una respuesta bruta estándar de AVS.
	El nombre coincide.	K	American Express	El nombre del miembro de la tarjeta coincide, pero la dirección de facturación y el código postal de facturación no coinciden.
	El código postal coincide, el nombre no coincide.	–	Visa, MasterCard, Discover, American Express	Sólo se utiliza para adquirentes que no utilizan una respuesta bruta AVS estándar.
	El código postal y la dirección coinciden, el nombre no coincide.	–	Visa, MasterCard, Discover, American Express	Sólo se utiliza para entidades adquirentes que no utilizan una respuesta bruta estándar de AVS.
	25	La dirección coincide, el nombre no coincide.	–	Visa, MasterCard, Discover, American Express	Sólo se utiliza para entidades adquirentes que no utilizan una respuesta en bruto AVS estándar.
26	Ni el código postal, ni la dirección ni el nombre coinciden.	–	Visa, MasterCard, Discover, American Express	Sólo se utiliza para entidades adquirentes que no utilizan una respuesta bruta AVS estándar.