AMEX
American Express (AMEX) é uma rede de pagamento global de primeira linha, conhecida por titulares de cartões de alto valor e protocolos de segurança avançados. Ao integrar diretamente com AMEX via ISO 8583, os comerciantes Deuna ignoram gateways de terceiros para reduzir a latência, minimizar os custos de processamento e obter controle granular sobre os dados da transação.
Operações suportadas
A integração AMEX na sua estratégia de pagamento com DEUNA permite realizar as seguintes operações:
| Operação | Nome AMEX | Solicitação/resposta MTI |
|---|---|---|
| Autorização | Autorização | 1100/ 1110 |
| Compra (captura automática em Deuna) | Autorização | 1100 / 1110 |
| Reembolso total – dia seguinte/reembolso parcial | Reembolso | Solicitação off-line |
| Captura total/parcial | Capturar | Solicitação off-line |
| Reembolso total – mesmo dia | Reversão de Autorização | 1420 / 1430 |
| Vazio | Reversão de Autorização | 1420 / 1430 |
Recursos suportados
- 3DS (Deuna ou MPI externo)
- Parcelas
- MOTO
- Informações da companhia aérea
Métodos de pagamento suportados
- Cartões de Débito e Crédito: Visa, Mastercard, AMEX
Processo de liquidação
A integração AMEX requer um processo de duas etapas para oferecer um processo de reconciliação mais confiável e eficiente. Em vez de compensar cada transação, uma por uma, em tempo real, todas as autorizações aprovadas são agrupadas e enviadas juntas no final do dia em um único arquivo em lote. Isso torna a contabilidade diária, a auditoria e a verificação de erros significativamente mais gerenciáveis. O corte acontece às 23h, horário CDMX.
Este processo se reflete no status do pagamento em Deuna conforme explicado na tabela a seguir:
| Operação | Nome AMEX | Solicitação/resposta MTI | Pré-liquidação do status Deuna | Status Deuna após liquidação |
|---|---|---|---|---|
| Autorização | Autorização | 1100/ 1110 | Autorizado | Autorizado (sem alteração) |
| Compra (captura automática) | Autorização | 1100 / 1110 | Processamento | Processado |
| Reembolso total – dia seguinte/reembolso parcial | Reembolso | Solicitação off-line | Reembolso/Reembolso Parcial | Reembolsado/Reembolsado Parcialmente |
| Captura total/parcial | Capturar | Solicitação off-line | Captura/Captura Parcial | Capturado/Capturado Parcialmente |
| Reembolso total – mesmo dia | Reversão de Autorização | 1420 / 1430 | Reembolsado | Reembolsado (sem alteração, cancelamento on-line) |
| Vazio | Reversão de Autorização | 1420 / 1430 | Anulado | Anulado (sem alteração, cancelamento on-line) |
Integrar AMEX#
Como orquestradora de pagamentos e fraudes, nossa plataforma permite que você conecte facilmente sua conta de comerciante AMEX diretamente ao seu fluxo de pagamento. Isso permite que você aproveite os recursos de processamento da AMEX como parte de uma estratégia de pagamento sofisticada e baseada em regras, ajudando a otimizar as taxas de aceitação e reduzir custos.
Este guia orientará você nas credenciais necessárias para conectar o AMEX em nosso Admin.
Requisitos
Antes de poder configurar AMEX em nosso Admin, você deve ter uma conta de comerciante ativa com eles. Durante a sua integração, a AMEX fornecerá um conjunto de credenciais exclusivas para sua integração ISO direta.
Reúna os seguintes campos obrigatórios do seu gerente de integração AMEX ou dos documentos de boas-vindas:
- ID de afiliação (ID do comerciante, número SE): Seu identificador exclusivo de 10 dígitos para sua conta de comerciante.
- Terminal ID: um código exclusivo que identifica um terminal específico em um estabelecimento comercial.
Etapas de configuração
Conectar AMEX é uma configuração simples e única em nosso portal de administração.
-
Faça login no seu portal de administração.
-
Navegue até Conexões under Payments section**,** find AMEX e selecione Connect.
Exemplo interativoUsa dados de exemplo e não faz solicitações à API.PagamentosAcme LATAM · ProduçãoConexões
Descubra e gerencie integrações de pagamento, carteiras e antifraude.
Conexões Tipo Status Ação Adyen Gateway de pagamento Conectada Worldpay Gateway de pagamento Conectada PayPal Forma de pagamento Conectada Mercado Pago Forma de pagamento Não conectada Riskified Mecanismo antifraude Não conectada -
Um formulário aparecerá. Insira cuidadosamente as seguintes informações junto com as credenciais coletadas da AMEX e de seu consultor Deuna
Nome
Detalhe
Moeda
Selecione a moeda do processador de pagamento
Affiliation ID
Seu identificador exclusivo de 10 dígitos para sua conta de comerciante obtido na AMEX
ID do remetente (fornecido por Deuna)
ID do remetente fornecido pelo seu consultor Deuna
Acquirer Afiliation ID
Use os seguintes códigos dependendo da região da sua conta de comerciante:
- EUA: 10000000002
- Canadá: 10000000006
- México: 10000000005
- Argentina: 10000000085
- EMEA (Europa, Oriente Médio, África): 10000000232
- Japão: 10000000319
ID do terminal (sugerido "00000001")
Use “00000001” a menos que AMEX ou Deuna recomendem um valor diferente.
Código de dados do ponto de venda (POS) (padrão "1000S0100010")
Use “1000S0100010” a menos que AMEX ou Deuna recomendem um valor diferente.
Código de categoria do comerciante (4 dígitos)
Seu código de categoria de 4 dígitos como “4511”
Comprimento do código de aprovação (padrão "6")
Use “6” a menos que AMEX ou Deuna aconselhem um valor diferente.
Nome do comerciante
Nome comercial do comerciante
Endereço do comerciante (rua, número, número interno)
Endereço do comerciante composto por rua, número e interior (se aplicável).
Cidade Mercante
A cidade onde o comerciante está registrado
Código postal do comerciante (por exemplo, "11510")
O Código Postal onde os serviços são prestados ou onde o comerciante está registado
Código do estado do comerciante (3 dígitos)
O código do estado de 3 dígitos onde os serviços são prestados ou o comerciante está registrado. Para Estados compostos por códigos de 2 dígitos, deverá adicionar um espaço. Exemplo: Flórida -> "FL"
Código do país do comerciante (3 dígitos numéricos)
O país onde os serviços são prestados ou onde o comerciante está registado, em formato de 3 dígitos numéricos.
ID do vendedor (somente para modo agregador. Padrão "0000000000")
Use “0000000000” a menos que AMEX ou Deuna aconselhem um valor diferente.
E-mail do vendedor (somente para modo agregador. Padrão "merchant@merchant.com")
Usar “merchant@merchant.com” a menos que AMEX ou Deuna aconselhem um valor diferente.
Telefone do vendedor (somente para modo agregador. Padrão "55555555555")
Use “55555555555” a menos que AMEX ou Deuna recomendem um valor diferente.
Código de motivo da mensagem (padrão "1900")
Use “1900” a menos que AMEX ou Deuna recomendem um valor diferente.
Código de processamento de autenticação ("004000" ou "004800" para ativar AAV)
Caso você decida utilizar o serviço de verificação de endereço (AVV) da AMEX use “004800”, caso contrário, use “004000”.
Tipo de verificação automatizada de endereço (AAV) ("AD" ou "AE". Sugerido "AD")
Se você decidiu usar o AAV da AMEX:
Use "AD" (sugerido) ou "AE" dependendo de suas necessidades:
-
Autorização Padrão (AD): é usada para enviar vários níveis de titular do cartão e dados de envio para verificação.
-
Autorização Aprimorada (AE): oferece suporte a todas as funcionalidades do formato AD, ao mesmo tempo que fornece opções de verificação adicionais para o número de telefone de cobrança do titular do cartão e o e-mail do cliente.
Caso não utilize o AAV da AMEX, utilize “AD” neste campo. |
-
Selecione se deseja esta conexão em modo Venda (Compra) ou Pré Autorização (Autorização).
-
Se necessário, você pode ativar o 3DS gerenciado pela DEUNA para conexões AMEX compatíveis seguindo o Guia de configuração 3DS.
-
Clique "Salvar".
-
Nosso sistema validará as credenciais e AMEX aparecerá como "Ativo" na sua lista de processadores conectados.
Cartões de teste#
A AMEX depende de PAN e valores específicos para aprovar as transações em seu ambiente Sandbox. Qualquer combinação diferente de PAN e valor resultará em uma transação negada com códigos de erro genéricos como pick up card:
| PAN | order.total_amount (em centavos) | Expiração | CVV (CID) |
|---|---|---|---|
| 373953192351004 | 52500 | Qualquer um no futuro | Qualquer |
| 373953192351004 | 53000 | Qualquer um no futuro | Qualquer |
| 373953192351004 | 56500 | Qualquer um no futuro | Qualquer |
| 373953192351004 | 57500 | Qualquer um no futuro | Qualquer |
| 373953192351004 | 58500 | Qualquer um no futuro | Qualquer |
| 373953192351004 | 59500 | Qualquer um no futuro | Qualquer |
| 373953192351004 | 61000 | Qualquer um no futuro | Qualquer |
Detalhes Técnicos: Autorização ISO 8583#
Nossa integração utiliza o 1100 (Solicitação de Autorização) e 1110 (Resposta de Autorização) tipos de mensagens. Para manter altas taxas de aprovação e garantir a transferência de responsabilidade, os seguintes campos são obrigatórios ou altamente recomendados:
Nota: Esta é uma lista representativa dos campos mais comuns usados para uma autorização de comércio eletrônico e não uma especificação exaustiva.
| Campo | Nome do campo | Descrição |
|---|---|---|
| MTI | Identificador de tipo de mensagem | 1100 indica uma solicitação de autorização |
| Campo 2 | Número da conta principal (PAN) | O número do cartão de 16 a 19 dígitos do cliente. Mostrado mascarado como um número de identificação do cartão. |
| Campo 3 | Código de processamento | Indica o tipo de transação (por exemplo, 200.000 para Compra). |
| Campo 4 | Valor, transação | O valor total da compra na moeda da transação. Mostrado em centavos. |
| Campo 7 | Data e hora de transmissão | A data e hora em que a transação foi iniciada (MMDDhh:mm:ss). |
| Campo 11 | Número de auditoria de rastreamento do sistema (STAN) | Um número exclusivo de 6 dígitos para identificar a transação. |
| Campo 12 | Data e hora local da transação | A data e hora em que a transação foi iniciada (AAMMDDhh:mm:ss). |
| Campo 14 | Data de expiração | A data de validade do cartão no formato AAMM. Mostrado com hash. |
| Campo 19 | Código do país | Código do país de 3 dígitos da transação. Mostrado com hash. |
| Campo 22 | Dados de PDV | Para comércio eletrônico, isso indica o status de cartão não presente. Espere “1000S0100010” |
| Campo 24 | Código de função | Código de operação de 3 dígitos (autorização, reembolso, etc). Mostrado com hash. |
| Campo 25 | Código de motivo da mensagem | Código de motivo da mensagem (“1900”). Mostrado com hash. |
| Campo 26 | Código comercial do aceitador de cartão | MCC do comerciante. |
| Campo 27 | Código de aprovação | Comprimento do código de aprovação ("6") |
| Campo 32 | Acquirer Institution ID | ID de afiliação do adquirente. Exemplo “100000000”. |
| Campo 37 | Número de referência de recuperação | Valor exclusivo de 12 dígitos durante um período de 24 horas para identificar a transação. Mostrado com hash. |
| Campo 41 | Card Acceptor Terminal ID | Seu ID de terminal (TID) de 8 dígitos. Exemplo “00000001” |
| Campo 42 | Código de identificação do aceitante do cartão (ID do comerciante) | Seu ID de comerciante de 10 dígitos (nas suas configurações). |
| Campo 43 | Localização do nome do aceitante do cartão | Nome do comerciante, nome da cidade do comerciante conforme definido nas credenciais |
| Campo 47 | Dados adicionais nacionais | Detalhes de faturamento, envio e companhia aérea |
| Campo 48 | Dados privados adicionais | Indicador de Pagamento Estendido American Express, que consiste no Tipo de Plano e no Número de Parcelas. Os tipos de planos são 03 (parcelamento) e 05 (meses diferidos): Exemplo: “0306”. Pode ser mostrado com hash. |
| Campo 49 | Código de moeda, transação | O código monetário ISO numérico de 3 dígitos (por exemplo, 840 para USD). Mostrado com hash |
| Campo 61 | Dados de uso nacional | Contém 3-D Secure 2.x e detalhes do comerciante |
| Campo 63 | Dados privados | Contém dados AAV |
Campo 47 Dados Adicionais Nacionais (dados de Faturamento, Remessa e Companhia Aérea)
| Campo 47 | Nome do campo | Descrição |
|---|---|---|
| Subcampo 0 | Marca e tipo de transação | 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) | O ID de e-mail do cliente é “CE” literal e constante |
| Subcampo 2 | (Não enviado em pedidos de companhias aéreas) E-MAIL DO CLIENTE | Exemplo: CFFROST@EMAILADDRESS.COM |
| Subcampo 3 | (Not sent in Airline orders) CUSTOMER HOSTNAME ID (CHID) | O ID do HostName do cliente é literal constante “CH” |
| Subcampo 4 | (Não enviado em pedidos de companhias aéreas) NOME DO CLIENTE. | O domínio de e-mail do cliente. Exemplo “GMAIL.COM” |
| Subcampo 5 | (Not sent in Airline orders) HTTP BROWSER TYPE ID (HBT ID) | O ID do tipo de navegador HTTP é literal constante “HBT” |
| Subcampo 6 | (Não enviado em pedidos de companhias aéreas) TIPO DE NAVEGADOR HTTP | Agente de usuário da solicitação: Exemplo: MOZILLA/4.0~(COMPATIBLE; |
| Subcampo 7 | (Not sent in Airline orders) SHIP TO COUNTRY ID (STC ID) | O ID do país de envio é constante e literal “STC” |
| Subcampo 8 | (Não enviado em pedidos de companhias aéreas) ENVIAR PARA O PAÍS | Código de país numérico de três dígitos. Exemplo 840 |
| Subcampo 9 | (Not sent in Airline orders) SHIPPING METHOD ID (SM ID) | O ID do método de envio é literal constante “SM” |
| Subcampo 10 | (Não enviado em pedidos aéreos) MÉTODO DE ENVIO | O valor para pedidos de retirada é “06”, caso contrário “03” (shipping_options.type) |
| Subcampo 11 | (Not sent in Airline orders) MERCHANT PRODUCT SKU ID (MPS ID) | O ID do SKU do produto do comerciante é literal constante “MPS” |
| Subcampo 12 | (Não enviado em pedidos de companhias aéreas) SKU DO PRODUTO COMERCIAL | SKU do item mais caro enviado no pedido. Caso nenhum SKU seja enviado, o valor é "ND" |
| Subcampo 13 | (Não enviado em pedidos de companhias aéreas) IP DO CLIENTE | Endereço IP da Internet do cliente |
| Subcampo 14 | (Não enviado em pedidos de companhias aéreas) CLIENTE ANI | telefone sem “+” ou espaços |
| Subcampo 16 | (Apenas para pedidos de companhias aéreas) DATA DE PARTIDA | Data de partida (formato CCYYMMDD) como “20030101” |
| Subcampo 17 | (Only for Airline orders) AIRLINE PASSENGER NAME ID (APN ID) | O ID do nome do passageiro da companhia aérea é literal constante “APN” |
| Subcampo 18 | (Apenas para pedidos de companhias aéreas) NOME DO PASSAGEIRO | Nome do passageiro no formato: "FROST JANE M MRS" |
| Subcampo 19 | (Apenas para pedidos de companhias aéreas) ORIGEM (Aeroporto de Origem) | Aeroporto de origem para o primeiro segmento de viagem: código IATA do aeroporto de origem como “SEA” |
| Subcampo 20 | (Apenas para pedidos de companhias aéreas) DEST | Aeroporto de destino para o primeiro trecho da viagem: código IATA do aeroporto de destino JFK |
| Subcampo 21 | (Only for Airline orders) ROUTING ID (RTG ID) | O ID de roteamento é literal constante “RTG” |
| Subcampo 22 | (Somente para pedidos de companhias aéreas) NÚMERO DE CIDADES | Contagem do total de cidades visitadas nos aeroportos de origem e de destino. |
| Subcampo 23 | (Somente para pedidos de companhias aéreas) CIDADES DE ROTEAMENTO | Códigos de aeroporto ou cidade de rota para cada trecho no bilhete (incluindo ORIGEM e DEST): STL / JFK / MIA |
| Subcampo 24 | (Only for Airline orders) AIRLINE CARRIERS ID (ALC ID) | O ID da companhia aérea é constante e literal “ALC” |
| Subcampo 25 | (Apenas para pedidos de companhias aéreas) NÚMERO DE TRANSPORTADORAS AÉREAS | Número de companhias aéreas na viagem |
| Subcampo 26 | (Apenas para pedidos de companhias aéreas) TRANSPORTADORAS AÉREAS | Código da companhia aérea para cada trecho do bilhete (incluindo ORIGEM e DEST). Exemplo AB/DC/EF |
| Subcampo 27 | (Apenas para pedidos de companhias aéreas) BASE DE TARIFAS | “Negócios” |
| Subcampo 28 | (Apenas para pedidos de companhias aéreas) NÚMERO DE PASSAGEIROS | Número de passageiros no formato: 001 |
| Subcampo 29 | (Apenas para pedidos de companhias aéreas) IP DO CLIENTE | Endereço IP da Internet do cliente. Exemplo 127.142.151.223 |
| Subcampo 30 | (Only for Airline orders) USTOMER EMAIL ID (CE ID) | O ID de e-mail do cliente é “CE” literal e constante |
| Subcampo 31 | (Only for Airline orders) USTOMER EMAIL ID | Endereço de e-mail do cliente. Exemplo:CFFROST@EMAILADDRESS.COM |
Campo 61 Subcampos principais (detalhes 3DS)
| Campo 61 | Nome do campo | Descrição |
|---|---|---|
| Subcampo 0 | Primary and Secondary ID | Valor constante “AXASK” |
| Subcampo 1 | INDICADOR DE COMÉRCIO ELETRÔNICO (ICE) | Valores possíveis: 05 = Autenticado com AEVV, 06 = Tentativa de AEVV, 07 = Não Autenticado |
| Subcampo 2 | AMERICAN EXPRESS VERIFICATION VALUE (AEVV) ID | Valor constante “AEVV” |
| Subcampo 3 | AMERICAN EXPRESS VERIFICATION VALUE | (AEVV) valor criptográfico derivado pelo Emissor com os resultados da autenticação de pagamento American ExpressSafeKey. É um base64 de 28 caracteres, quando decodificado pode mostrar informações importantes sobre a análise realizada. Exemplo: “AAkBAmRGkyNEM1J5EkaTAAAAAAA=" |
| Subcampo 4 | AMERICAN EXPRESS SAFEKEY TRANSACTION ID (XID) | Valor constante “XID” |
| Subcampo 5 | AMERICAN EXPRESS SAFEKEY TRANSACTION ID VALUE | O identificador de transação American Express SafeKey é determinado durante a autenticação de pagamento American Express SafeKey. Valor Base64. Exemplo: “AgIAADm0+B7htUfXuLAUcDlOUtM=” |
Campo 63 Subcampos principais (dados AAV)
| Campo 63 | Nome do campo | Descrição |
|---|---|---|
| Subcampo 1 | IDENTIFICADOR DE SERVIÇO (AX) | “AX” constante |
| Subcampo 2 | REQUEST TYPE IDENTIFIER | Tipo AAV selecionado na configuração, “AD” ou “AE” |
| Subcampo 3 | CARDMEMBER BILLING POSTAL CODE | Exemplo “98107” |
| Subcampo 4 | CARDMEMBER BILLING ADDRESS | Exemplo “6201 14TH AVE NW” |
| Subcampo 5 | CARDMEMBER FIRST NAME | Exemplo “LEAO” |
| Subcampo 6 | CARDMEMBER LAST NAME | Exemplo “BUTRON” |
| Subcampo 7 | CARDMEMBER BILLING PHONE NUMBER | Número de telefone de cobrança. Exemplo “4155688537” |
| Subcampo 8 | SHIP-TO POSTAL CODE | Exemplo “98107” |
| Subcampo 9 | SHIP-TO ADDRESS | Exemplo “6201 14TH AVE NW” |
| Subcampo 10 | SHIP-TO FIRST NAME | Exemplo “LOURDES” |
| Subcampo 11 | SHIP-TO LAST NAME | Exemplo “MONTENEGRO” |
| Subcampo 12 | SHIP-TO PHONE NUMBER | Exemplo “4155797662” |
| Subcampo 13 | SHIP-TO COUNTRY CODE | Código do país em número de 3 dígitos como “840” |
Tanto a Solicitação quanto as Respostas compartilham os mesmos nomes e informações de campos na maioria dos casos, sendo a principal diferença nos campos 38 e 39, que estão relacionados aos resultados da autorização:
- Campo 38: Código de autorização solicitação de autorização ou estorno (nulo).
- Campo 39: As solicitações de Autorização Aprovadas terão o valor “000”, e a solicitação de Estornos Aprovados terá o valor “400” em caso de reversões (nulo). Cada valor diferente estará relacionado a um código de erro que será exibido no Admin junto com sua descrição.
- Campo 44: Código do resultado AVS expresso em letra de um dígito. Os valores possíveis são explicados na próxima seção.
Resultados AVS
Quando AMEX AVS (AAV) estiver habilitado na configuração com o valor “004800”, o campo 44 retornará o resultado AVS em letras de um dígito, que terá equivalente em códigos de erro Deuna AVS:
| Código Amex AAV | Definição | Código Deuna AVS |
|---|---|---|
| Z | Apenas o CEP está correto | A01 |
| Um | Apenas o endereço está correto | A02 |
| K | Apenas o nome do titular do cartão está correto | A03 |
| Ó | O nome e endereço do titular do cartão estão corretos | A04 |
| eu | O nome do titular do cartão e o CEP estão corretos | A05 |
| S | Endereço e CEP são correto | A06 |
| N | Endereço e CEP são incorreto | A07 |
| M | O nome, endereço e CEP do titular do cartão estão corretos | A08 |
| E | Nome do titular do cartão incorreto, endereço correto, CEP correto | A12 |
| F | Nome do titular do cartão incorreto, endereço correto, CEP incorreto | A13 |
| D | Nome do titular do cartão incorreto, endereço incorreto, CEP correto | A14 |
| W | O nome, endereço e CEP do titular do cartão estão todos incorretos | A15 |
| Você | As informações de verificação de endereço não estão disponíveis | A16 |
| S | A verificação de endereço não é permitida | A17 |
| R | A verificação de endereço não está disponível. Tente novamente. | A18 |
Próximas etapas#
Sua conexão AMEX agora está ativa!
A etapa final é incorporá-lo ao seu fluxo de transação. Vá para o Estratégia de Pagamento seção do Admin para criar regras que definam quais transações são roteadas para AMEX (por exemplo, "Rotear todas as transações em EUR para AMEX").
Estratégias de pagamento
Configure o processamento padrão e as regras para cada fluxo de pagamento.
Processamento padrão
Configure o processamento padrão e as regras para cada fluxo de pagamento.
| Regra | Roteamento | Status | Ação |
|---|---|---|---|
| Processamento padrão | Adyen → Worldpay | Ativa |
Regras específicas
Configure o processamento padrão e as regras para cada fluxo de pagamento.
| Prioridade | Regra | Condições | Roteamento | Status |
|---|---|---|---|---|
| 1 | Pedidos de alto valor | Valor acima de USD 100 | Adyen → Worldpay | Ativa |