AMEX | DEUNA Docs

En esta página

Integrar AMEX
Tarjetas de prueba
Detalles técnicos: Autorización ISO 8583
Pasos siguientes

American Express (AMEX) es una red de pagos global líder, conocida por sus tarjetas de alto valor y sus protocolos de seguridad avanzados. Mediante la integración directa con AMEX a través de ISO 8583, Deuna permite a sus comercios evitar los gateways de terceros para reducir la latencia, minimizar los costos de procesamiento y obtener un control detallado sobre los datos de las transacciones.

Operaciones soportadas

La integración de AMEX en su estrategia de pagos con Deuna le permite realizar las siguientes operaciones:

Operación	Nombre de AMEX	Solicitud / Respuesta MTI
Autorización	Autorización	1100/ 1110
Compra (Captura automática en Deuna)	Autorización	1100 / 1110
Reembolso completo - Día siguiente / Reembolso parcial	Reembolso	Solicitud fuera de línea
Captura completa / parcial	Captura	Solicitud fuera de línea
Reembolso completo - Día de la compra	Revocación de autorización	1420 / 1430
Anulación	Revocación de autorización	1420 / 1430

Características soportadas

3DS (Deuna o MPI externo)
Plazos
MOTO
Información de aerolíneas

Métodos de pago soportados

Tarjetas de débito y crédito: Visa, Mastercard, AMEX

Proceso de liquidación

La integración de AMEX requiere un proceso de dos pasos para ofrecer un proceso de conciliación más fiable y eficiente. En lugar de procesar cada transacción individualmente en tiempo real, todas las autorizaciones aprobadas se agrupan y se envían juntas al final del día en un único archivo por lote. Esto facilita significativamente la contabilidad diaria, la auditoría y la verificación de errores. El corte se realiza a las 11:00 PM, hora de CDMX.

Este proceso se refleja en el estado de pago en Deuna, según se explica en la siguiente tabla:

Operación	Nombre de AMEX	Solicitud / Respuesta MTI	Estado de Deuna antes de la liquidación	Estado de Deuna después de la liquidación
Autorización	Autorización	1100/ 1110	Autorizado	Autorizado (sin cambios)
Compra (Captura automática)	Autorización	1100 / 1110	Procesamiento	Procesado
Reembolso completo - Día siguiente / Reembolso parcial	Reembolso	Solicitud fuera de línea	Reembolso / Reembolso parcial	Reembolso / Reembolso parcial
Captura completa / parcial	Captura	Solicitud fuera de línea	Captura / Captura parcial	Capturado / Captura parcial
Reembolso completo - Día de la compra	Revocación de autorización	1420 / 1430	Reembolso	Reembolso (sin cambios, cancelación en línea)
Anulación	Revocación de autorización	1420 / 1430	Anulado	Anulado (sin cambios, cancelación en línea)

Integrar AMEX#

Como orquestador de pagos y fraude, nuestra plataforma le permite conectar fácilmente su cuenta de comerciante de AMEX directamente en su flujo de pagos. Esto le permite aprovechar las capacidades de procesamiento de AMEX como parte de una estrategia de pago sofisticada basada en reglas, lo que le ayuda a optimizar las tasas de aceptación y reducir los costos.

Esta guía le guiará a través de las credenciales necesarias para conectar AMEX en nuestro panel de administración.

Requisitos

Antes de poder configurar AMEX en nuestro panel de administración, debe tener una cuenta de comerciante activa con ellos. Durante su incorporación, AMEX le proporcionará un conjunto de credenciales únicas para su integración ISO directa.

Por favor, recopile los siguientes campos requeridos de su gestor de integración de AMEX o de los documentos de bienvenida:

ID de afiliación (ID de comerciante, Número SE): Su identificador único de 10 dígitos para su cuenta de comerciante.
Terminal ID: Un código único que identifica un terminal específico en la ubicación del comerciante.

Pasos de configuración

La conexión con AMEX es una configuración sencilla y única en nuestro portal de administración.

Inicie sesión en su portal de administración.

Navegue a Conexiones under Payments section**,** find AMEX y seleccione Connect.

Ejemplo interactivoUsa datos de ejemplo y no realiza solicitudes de API.

Pagos

Conexiones

Descubre y administra integraciones de pago, billeteras y antifraude.

Acme LATAM · Producción

Buscar conexiones

Conexiones	Tipo	Estado
Adyen	Pasarela de pago	Conectada
Worldpay	Pasarela de pago	Conectada
PayPal	Método de pago	Conectada
Mercado Pago	Método de pago	Sin conectar
Riskified	Motor antifraude	Sin conectar

Aparecerá un formulario. Introduzca cuidadosamente la siguiente información junto con las credenciales obtenidas de AMEX y de su asesor de Deuna

Nombre	Detalles
Moneda	Seleccione la moneda del procesador de pagos
Affiliation ID	Su identificador único de 10 dígitos para su cuenta de comerciante, obtenido de AMEX
ID del remitente (proporcionado por Deuna)	ID del remitente proporcionado por su asesor de Deuna
Acquirer Afiliation ID	Utilice los siguientes códigos según su región de cuenta de comerciante: EE. UU.: 10000000002 Canadá: 10000000006 México: 10000000005 Argentina: 10000000085 EMEA (Europa, Oriente Medio, África): 10000000232 Japón: 10000000319
ID de terminal (sugerido "00000001")	Utilice "00000001" a menos que AMEX o Deuna indiquen un valor diferente.
Código de datos de punto de venta (por defecto "1000S0100010")	Utilice "1000S0100010" a menos que AMEX o Deuna indiquen un valor diferente.
Código de categoría del comerciante (4 dígitos)	Su código de categoría de 4 dígitos, como "4511"
Longitud del código de aprobación (por defecto "6")	Utilice "6" a menos que AMEX o Deuna indiquen un valor diferente.
Nombre del comerciante	Nombre comercial del comerciante
Dirección del comerciante (calle, número, número interior)	La dirección del comerciante, compuesta por calle, número y número interior (si corresponde).
Ciudad del comerciante	La ciudad donde está registrado el comerciante
Código postal del comerciante (por ejemplo, "11510")	El código postal donde se ofrecen los servicios o donde está registrado el comerciante
Código de estado del comerciante (3 dígitos)	El código de estado de 3 dígitos donde se ofrecen los servicios o donde está registrado el comerciante. Para estados compuestos por códigos de 2 dígitos, debe agregar un espacio. Ejemplo: Florida -> "FL "
Código de país del comerciante (numérico de 3 dígitos)	El país donde se ofrecen los servicios o donde está registrado el comerciante, en formato numérico de 3 dígitos.
ID del vendedor (solo para el modo agregador. Por defecto "0000000000")	Utilice "0000000000" a menos que AMEX o Deuna indiquen un valor diferente.
Correo electrónico del vendedor (solo para el modo agregador. Por defecto "merchant@merchant.com")	Utilice "merchant@merchant.com" a menos que AMEX o Deuna indiquen un valor diferente.
Número de teléfono del vendedor (solo para el modo agregador. Por defecto "55555555555")	Utilice "55555555555" a menos que AMEX o Deuna indiquen un valor diferente.
Código de razón del mensaje (por defecto "1900")	Utilice "1900" a menos que AMEX o Deuna indiquen un valor diferente.
Código de procesamiento de autorización ("004000" o "004800" para habilitar AAV)	Si decide utilizar el servicio de verificación de dirección de AMEX (AVV), utilice "004800", de lo contrario, utilice "004000".
Tipo de Verificación de Dirección Automática (AAV) ("AD" o "AE". Sugerido "AD")	Si ha decidido utilizar el AAV de AMEX: Utilice "AD" (sugerido) o "AE" según sus requisitos: Autorización, Estándar (AD): se utiliza para enviar varios niveles de datos de la tarjeta y datos de envío para verificación. Autorización, Mejorada (AE): admite todas las funcionalidades del formato AD, al tiempo que proporciona opciones de verificación adicionales para el número de teléfono de facturación de la tarjeta y la dirección de correo electrónico del cliente. Si no va a utilizar el AAV de AMEX, utilice "AD" en este campo. \|

Seleccione si desea que esta conexión se realice en un modo de Venta (Compra) o Preautorización (Autorización).
Si es necesario, puede habilitar 3DS administrado por DEUNA para conexiones AMEX compatibles siguiendo la guía de configuración de 3DS.
Haga clic "Guardar".
Nuestro sistema validará las credenciales y AMEX aparecerá como "Activo" en su lista de procesadores conectados.

Tarjetas de prueba#

AMEX requiere PAN y montos específicos para aprobar las transacciones en su entorno de prueba. Cualquier combinación diferente de PAN y monto resultará en una transacción denegada con códigos de error genéricos como pick up card:

PAN	monto total del pedido (en céntimos)	Fecha de vencimiento	CVV (CID)
373953192351004	52500	Cualquier fecha futura	Cual
373953192351004	53000	Cualquier fecha futura	Cual
373953192351004	56500	Cualquier fecha futura	Cual
373953192351004	57500	Cualquier fecha futura	Cual
373953192351004	58500	Cualquier fecha futura	Cual
373953192351004	59500	Cualquier fecha futura	Cual
373953192351004	61000	Cualquier fecha futura	Cual

Detalles técnicos: Autorización ISO 8583#

Nuestra integración utiliza el 1100 (Solicitud de autorización) y 1110 (Respuesta de Autorización) tipos de mensajes. Para mantener altas tasas de aprobación y garantizar la transferencia de responsabilidad, los siguientes campos son obligatorios o altamente recomendados:

Nota: Esta es una lista representativa de los campos más comunes utilizados para una autorización de comercio electrónico y no una especificación exhaustiva

Campo	Nombre del campo	Descripción
MTI	Identificador de tipo de mensaje	1100 Indica una Solicitud de Autorización
Campo 2	Número de cuenta principal (PAN)	El número de tarjeta del cliente, de 16 a 19 dígitos. Se muestra enmascarado como un número de ID de tarjeta.
Campo 3	Código de procesamiento	Indica el tipo de transacción (por ejemplo, 200000 para compra).
Campo 4	Monto, Transacción	El monto total de la compra en la moneda de la transacción. Se muestra en centavos.
Campo 7	Fecha y hora de transmisión	La fecha y hora en que se inició la transacción (MMDDhh:mm:ss).
Campo 11	Número de auditoría de rastreo del sistema (STAN)	Un número único de 6 dígitos para identificar la transacción.
Campo 12	Fecha y hora local de la transacción	La fecha y hora en que se inició la transacción (YYMMDDhh:mm:ss).
Campo 14	Fecha de vencimiento	La fecha de vencimiento de la tarjeta en formato YYMM. Se muestra hasheado.
Campo 19	Código de país	Código de país de 3 dígitos de la transacción. Se muestra hasheado.
Campo 22	Datos del POS	Para el comercio electrónico, esto indica el estado "sin tarjeta presente". Se espera "1000S0100010"
Campo 24	Código de función	Código de operación de 3 dígitos (autorización, reembolso, etc.). Se muestra hasheado.
Campo 25	Código de razón del mensaje	Código de razón del mensaje ("1900"). Se muestra hasheado.
Campo 26	Código de negocio del receptor	Código MCC del comerciante.
Campo 27	Código de aprobación	Longitud del código de aprobación ("6")
Campo 32	Acquirer Institution ID	ID de afiliación del adquirente. Ejemplo "100000000".
Campo 37	Número de referencia de recuperación	Valor único de 12 dígitos durante un período de 24 horas para identificar la transacción. Se muestra hasheado.
Campo 41	Card Acceptor Terminal ID	Su ID de terminal (TID) de 8 dígitos. Ejemplo "00000001"
Campo 42	Código de identificación del receptor	Su ID de comerciante de 10 dígitos (del panel de control).
Campo 43	Ubicación del nombre del receptor	Nombre del comerciante, Nombre de la ciudad del comerciante según los credenciales
Campo 47	Datos adicionales nacionales	Detalles de facturación, envío y de aerolínea
Campo 48	Datos privados adicionales	Indicador de pago extendido de American Express, que consiste en el tipo de plan y el número de cuotas. Los tipos de plan son 03 (plan de cuotas) y 05 (meses diferidos): Ejemplo: "0306". Puede mostrarse hasheado.
Campo 49	Código de moneda, Transacción	El código numérico ISO de 3 dígitos de la moneda (por ejemplo, 840 para USD). Se muestra hasheado
Campo 61	Datos de uso nacional	Contiene 3D Secure 2.x y detalles del comerciante
Campo 63	Datos privados	Contiene datos AAV

Campo 47 Datos adicionales Nacionales (Información de facturación, envío y aerolínea)

Campo 47	Nombre del campo	Descripción
Subcampo 0	Marca y tipo de transacción	Concat of two digit card brand code, in case is not airlines or IAC if is airline order. “AXITD”
Subcampo 1	(Not sent in Airline orders) CUSTOMER EMAIL ID (CE ID)	El ID de correo electrónico del cliente es una cadena literal constante "CE"
Subcampo 2	(No se envía en pedidos de aerolíneas) CORREO ELECTRÓNICO DEL CLIENTE	Ejemplo: CFFROST@EMAILADDRESS.COM
Subcampo 3	(Not sent in Airline orders) CUSTOMER HOSTNAME ID (CHID)	El ID de hostname del cliente es una cadena literal constante "CH "
Subcampo 4	(No se envía en pedidos de aerolíneas) HOSTNAME DEL CLIENTE.	El dominio de correo electrónico del cliente. Ejemplo "GMAIL.COM"
Subcampo 5	(Not sent in Airline orders) HTTP BROWSER TYPE ID (HBT ID)	El ID de tipo de navegador HTTP es una cadena literal constante "HBT"
Subcampo 6	(No se envía en pedidos de aerolíneas) TIPO DE NAVEGADOR HTTP	Agente de usuario de la solicitud: Ejemplo: MOZILLA/4.0~(COMPATIBLE;~~MSIE~~5.0;~~WINDOWS~~95)
Subcampo 7	(Not sent in Airline orders) SHIP TO COUNTRY ID (STC ID)	El ID de país de destino es una cadena literal constante "STC"
Subcampo 8	(No se envía en pedidos de aerolíneas) PAÍS DE DESTINO	Código numérico de tres dígitos. Ejemplo 840
Subcampo 9	(Not sent in Airline orders) SHIPPING METHOD ID (SM ID)	El ID de método de envío es una cadena literal constante "SM"
Subcampo 10	(No se envía en pedidos de aerolíneas) MÉTODO DE ENVÍO	El valor para pedidos de recogida es "06", en caso contrario "03" (shipping_options.type)
Subcampo 11	(Not sent in Airline orders) MERCHANT PRODUCT SKU ID (MPS ID)	El ID de SKU del producto del comerciante es una cadena literal constante "MPS"
Subcampo 12	(No se envía en pedidos de aerolíneas) SKU DEL PRODUCTO DEL COMERCIANTE	SKU del artículo más caro enviado en el pedido. Si no se envía ningún SKU, el valor es "ND"
Subcampo 13	(No se envía en pedidos de aerolíneas) IP DEL CLIENTE	Dirección IP de Internet del cliente
Subcampo 14	(No se envía en pedidos de aerolíneas) ANI DEL CLIENTE	Número de teléfono sin " + " ni espacios
Subcampo 16	(Solo para pedidos de aerolíneas) FECHA DE SALIDA	Fecha de salida (formato CCYYMMDD) como "20030101"
Subcampo 17	(Only for Airline orders) AIRLINE PASSENGER NAME ID (APN ID)	El ID de nombre del pasajero de la aerolínea es una cadena literal constante "APN"
Subcampo 18	(Solo para pedidos de aerolíneas) NOMBRE DEL PASAJERO	Nombre del pasajero en el formato: "FROST JANE M MRS"
Subcampo 19	(Solo para pedidos de aerolíneas) ORIGEN (Aeropuerto de origen)	Aeropuerto de origen para el primer segmento de viaje: Código IATA del aeropuerto de origen como "SEA"
Subcampo 20	(Solo para pedidos de aerolíneas) DEST	Aeropuerto de destino para el primer segmento de viaje: Código IATA del aeropuerto de destino JFK
Subcampo 21	(Only for Airline orders) ROUTING ID (RTG ID)	El ID de ruta es una cadena literal constante "RTG"
Subcampo 22	(Solo para pedidos de aerolíneas) NÚMERO DE CIUDADES	Conteo de todas las ciudades visitadas desde los aeropuertos de origen y destino.
Subcampo 23	(Solo para pedidos de aerolíneas) CIUDADES DE LA RUTARE	Códigos de aeropuerto o ciudad para cada tramo del billete (incluidos ORIGIN y DEST): STL / JFK / MIA
Subcampo 24	(Only for Airline orders) AIRLINE CARRIERS ID (ALC ID)	El ID de transportistas de aerolíneas es una cadena literal constante "ALC"
Subcampo 25	(Solo para pedidos de aerolíneas) NÚMERO DE AEROLÍNEAS	Número de aerolíneas en el vuelo
Subcampo 26	(Solo para pedidos de aerolíneas) AEROLÍNEAS	Código de aerolínea para cada tramo del billete (incluyendo ORIGEN y DESTINO). Ejemplo AB / DC / EF
Subcampo 27	(Solo para pedidos de aerolíneas) BASE DE PRECIO	"Business"
Subcampo 28	(Solo para pedidos de aerolíneas) NÚMERO DE PASAJEROS	Número de pasajeros en el formato: 001
Subcampo 29	(Solo para pedidos de aerolíneas) IP DEL CLIENTE	Dirección IP de Internet del cliente. Ejemplo 127.142.151.223
Subcampo 30	(Only for Airline orders) USTOMER EMAIL ID (CE ID)	El ID de correo electrónico del cliente es una cadena literal constante "CE"
Subcampo 31	(Only for Airline orders) USTOMER EMAIL ID	Dirección de correo electrónico del cliente. Ejemplo:CFFROST@EMAILADDRESS.COM

Campo 61 Subcampos clave (detalles de 3DS)

Campo 61	Nombre del campo	Descripción
Subcampo 0	Primary and Secondary ID	Valor constante "AXASK"
Subcampo 1	INDICADOR DE COMERCIO ELECTRÓNICO (ECI)	Posibles valores: 05 = Autenticado con AEVV, 06 = Intentado con AEVV, 07 = No autenticado
Subcampo 2	AMERICAN EXPRESS VERIFICATION VALUE (AEVV) ID	Valor constante "AEVV"
Subcampo 3	AMERICAN EXPRESS VERIFICATION VALUE	(AEVV) Valor criptográfico derivado por el Emisor con los resultados de autenticación de pago American ExpressSafeKey. Es un valor base64 de 28 caracteres, cuando se decodifica, puede mostrar información clave sobre el análisis realizado. Ejemplo: "AAkBAmRGkyNEM1J5EkaTAAAAAAA="
Subcampo 4	AMERICAN EXPRESS SAFEKEY TRANSACTION ID (XID)	Valor constante "XID"
Subcampo 5	AMERICAN EXPRESS SAFEKEY TRANSACTION ID VALUE	El identificador de transacción American Express SafeKey se determina durante la autenticación de pago American Express SafeKey. Valor base64. Ejemplo: "AgIAADm0+B7htUfXuLAUcDlOUtM=”

Campo 63 Subcampos clave (datos AAV)

Campo 63	Nombre del campo	Descripción
Subcampo 1	IDENTIFICADOR DE SERVICIO (AX)	Valor constante "AX"
Subcampo 2	REQUEST TYPE IDENTIFIER	Tipo AAV seleccionado en la configuración, ya sea "AD" o "AE"
Subcampo 3	CARDMEMBER BILLING POSTAL CODE	Ejemplo "98107"
Subcampo 4	CARDMEMBER BILLING ADDRESS	Ejemplo "6201 14TH AVE NW"
Subcampo 5	CARDMEMBER FIRST NAME	Ejemplo "LEAO"
Subcampo 6	CARDMEMBER LAST NAME	Ejemplo "BUTRON"
Subcampo 7	CARDMEMBER BILLING PHONE NUMBER	Número de teléfono de facturación. Ejemplo "4155688537"
Subcampo 8	SHIP-TO POSTAL CODE	Ejemplo "98107"
Subcampo 9	SHIP-TO ADDRESS	Ejemplo "6201 14TH AVE NW"
Subcampo 10	SHIP-TO FIRST NAME	Ejemplo "LOURDES"
Subcampo 11	SHIP-TO LAST NAME	Ejemplo "MONTENEGRO"
Subcampo 12	SHIP-TO PHONE NUMBER	Ejemplo "4155797662"
Subcampo 13	SHIP-TO COUNTRY CODE	Código de país en número de 3 dígitos como "840"

Tanto las solicitudes como las respuestas comparten los mismos nombres de campo y la misma información en la mayoría de los casos, siendo la principal diferencia en el campo 38 y 39, que están relacionados con los resultados de la autorización:

Campo 38: Código de autorización o reversión (anulación) de la solicitud.
Campo 39: Las solicitudes de autorización aprobadas tendrán el valor "000", y las solicitudes de reversión aprobadas tendrán el valor "400" en caso de reversiones (anulación). Cualquier valor diferente estará relacionado con un código de error que se mostrará en el panel de administración junto con su descripción.
Campo 44: Código de resultado AVS expresado en una letra. Los posibles valores se explican en la siguiente sección.

Resultados AVS

Cuando AMEX AVS (AAV) está habilitado en la configuración con el valor "004800", el campo 44 devolverá el resultado AVS en letras, que tendrá un equivalente en los códigos de error AVS de Deuna:

Código AAV de Amex	Definición	Código AVS de Deuna
z	Solo el código postal es correcto	A01
un	Solo la dirección es correcta	A02
k	Solo el nombre del titular de la tarjeta es correcto	A03
oh	Nombre y dirección del titular de la tarjeta son correctos	A04
l	Nombre y código postal del titular de la tarjeta son correctos	A05
Y	Dirección y código postal son correctos	A06
norte	Dirección y código postal son incorrecto	A07
m	Nombre, dirección y código postal del titular de la tarjeta son correctos	A08
mi	Nombre del titular de la tarjeta incorrecto, dirección correcta, código postal correcto	A12
f	Nombre del titular de la tarjeta incorrecto, dirección correcta, código postal incorrecto	A13
re	Nombre del titular de la tarjeta incorrecto, dirección incorrecta, código postal correcto	A14
W.	Nombre, dirección y código postal del titular de la tarjeta son incorrectos	A15
Ud.	La información de verificación de la dirección no está disponible	A16
S	La verificación de la dirección no está permitida	A17
R	La verificación de la dirección no está disponible, Inténtelo de nuevo.	A18

Pasos siguientes#

¡Su conexión con AMEX ya está activa!

El paso final es integrarlo en su flujo de transacciones. Vaya a la Estrategia de Pago y cree reglas que definan qué transacciones se dirigen a AMEX (por ejemplo, "Dirigir todas las transacciones en EUR a AMEX").

Ejemplo interactivoUsa datos de ejemplo y no realiza solicitudes de API.

Pagos

Estrategias de pago

Configura el procesamiento predeterminado y las reglas para cada flujo de pago.

Acme LATAM · Producción

Procesamiento predeterminado

Configura el procesamiento predeterminado y las reglas para cada flujo de pago.

Regla	Enrutamiento	Estado	Acción
Procesamiento predeterminado	Adyen → Worldpay	Activa

Reglas específicas

Configura el procesamiento predeterminado y las reglas para cada flujo de pago.

Prioridad	Regla	Condiciones	Enrutamiento	Estado
1	Órdenes de importe alto	Importe superior a USD 100	Adyen → Worldpay	Activa