Pular para o conteúdo principal
Nesta página

A American Express processa transações com cartão em sua própria rede e gera relatórios sobre elas por meio de arquivos, não de uma API. Este conector é apenas entrega de arquivo em lote: A Amex grava relatórios GRRCN em um local de Transferência Segura de Arquivos (SFT) uma vez por dia, e Athia os coleta e analisa a partir daí.

O que você ganha#

Tudo chega dentro do Relatórios GRRCN (Dados Brutos; Relatórios de Reconciliação Global):

  • Autorizações — montantes, datas e dados do regime.
  • Settlements.
  • Fees.
  • Disputes.

É assim que o volume Amex – que nunca aparece nos dados do seu adquirente – se junta ao restante do seu quadro de pagamento para reconciliação e análise de custos.

Antes de começar#

  • Uma conta Amex com um gerente de relacionamento quem pode configurar Transferência segura de arquivos (SFT) serviço para você.
  • Relatórios GRRCN configurados para entrega diária para esse local SFT. Solicite todos os relatórios GRRCN disponíveis — um relatório que nunca foi solicitado não pode ser preenchido por parte de Athia.
  • Os detalhes da conexão SFT em mãos. Amex os fornece; você não os cria.

Credenciais que Athia pede#

Todos os quatro valores vêm da Amex com a configuração SFT.

CampoObrigatórioO que é / onde encontrar
NomeSimSeu rótulo para esta conexão – nomeie-o para que a fonte Amex seja óbvia mais tarde
URL/HospedeiroSimO anfitrião do SFT Amex entrega, por exemplo, sft.americanexpress.com. Fornecido pelo seu gerente de relacionamento Amex
PortoSimA porta SFT - 22 para SFTP. Fornecido com o anfitrião
Nome de usuárioSimO nome de usuário da conta SFT emitido pela Amex
SenhaSimA senha dessa conta SFT. Armazene e transfira com segurança

Configurando a conexão#

  1. Entre em contato com seu Gerente de relacionamento Amex e peça-lhes para configurar o Amex Transferência segura de arquivos (SFT) service.
  2. Na mesma conversa, solicite entrega diária de todos os relatórios GRRCN disponíveis (dados brutos; relatórios de reconciliação global) para esse local de SFT.
  3. Colete os detalhes do SFT que a Amex fornece: URL/Hospedeiro, Porto, Nome de usuário e Senha.
  4. Passe esses detalhes para sua equipe Athia, juntamente com as contas de comerciante que você espera ver. Sua equipe Athia conclui a conexão e verifica se o local do SFT está acessível e se um arquivo de amostra pode ser lido.

Em caso de sucesso, a conexão é exibida como ACTIVE e a primeira importação é executada nos arquivos que já estão no local do SFT.

Webhook#

Amex não suporta webhooks e nenhuma pesquisa de API. Não há URL de notificação para registrar e nenhum endpoint para sondar. Cada campo neste conector chega no lote GRRCN diário.

Cadência de sincronização#

Diariamente, fixo. A cadência segue o cronograma de entrega da Amex, portanto não há Cronograma para escolher. Nada neste conector é em tempo real — uma transação fica visível no Athia depois de aparecer em um arquivo GRRCN.

Limites e coisas para saber#

  • A filtragem é limitada ao que os relatórios contêm. Não há interface de consulta por trás desse conector, portanto, se um campo não estiver em um relatório GRRCN, ele não estará disponível.
  • Somente produção. Não há caminho de sandbox para esse conector.
  • Solicite todos os relatórios GRRCN antecipadamente. Adicionar um tipo de relatório posteriormente significa voltar ao seu gerente de relacionamento e aguardar o próximo ciclo diário.
  • Várias contas de comerciante. Certifique-se de que todas as contas importantes para você estejam incluídas nos relatórios GRRCN. Quando a Amex emitir detalhes SFT separados por conta, forneça cada conjunto à sua equipe Athia.
  • O histórico anterior ao início da entrega é um carregamento separado. Roteie-o através de um arquivo drop - veja Integrando Athia.
  • Os dados do cartão são minimizados. Detalhe em nível de campo sobre a localização das lojas Athia Dicionário de dados Athia.

Solução de problemas#

O que você vêCausa provávelO que fazer
A verificação falha no acesso à localização do SFTHost ou porta errado ou a senha SFT foi alternada pela AmexReconfirmar URL/Hospedeiro, Porto, Nome de usuário e Senha com seu gerente de relacionamento Amex e forneça o conjunto atual à sua equipe Athia
ACTIVE, mas nenhum dado após a primeira sincronizaçãoNenhum arquivo GRRCN foi entregue no local aindaConfirme com seu gerente de relacionamento se os relatórios GRRCN estão configurados para entrega diária naquele local exato e aguarde o próximo ciclo diário
As autorizações chegam, mas as taxas, acordos ou disputas nãoApenas parte do conjunto de relatórios GRRCN foi configuradaPeça ao seu gerente de relacionamento para adicionar os relatórios GRRCN restantes à entrega diária
Uma conta de comerciante está totalmente ausenteEssa conta não está incluída nos relatórios GRRCN ou é entregue num local de SFT diferentePeça à Amex para adicioná-lo aos relatórios ou forneça seus detalhes de SFT separados para sua equipe Athia
As transações de hoje não são visíveisEsperado – a entrega é um lote diárioAguarde o próximo arquivo diário. Não há caminho mais rápido neste conector