Amex
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.
| Campo | Obrigatório | O que é / onde encontrar |
|---|---|---|
| Nome | Sim | Seu rótulo para esta conexão – nomeie-o para que a fonte Amex seja óbvia mais tarde |
| URL/Hospedeiro | Sim | O anfitrião do SFT Amex entrega, por exemplo, sft.americanexpress.com. Fornecido pelo seu gerente de relacionamento Amex |
| Porto | Sim | A porta SFT - 22 para SFTP. Fornecido com o anfitrião |
| Nome de usuário | Sim | O nome de usuário da conta SFT emitido pela Amex |
| Senha | Sim | A senha dessa conta SFT. Armazene e transfira com segurança |
Configurando a conexão#
- Entre em contato com seu Gerente de relacionamento Amex e peça-lhes para configurar o Amex Transferência segura de arquivos (SFT) service.
- 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.
- Colete os detalhes do SFT que a Amex fornece: URL/Hospedeiro, Porto, Nome de usuário e Senha.
- 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ável | O que fazer |
|---|---|---|
| A verificação falha no acesso à localização do SFT | Host ou porta errado ou a senha SFT foi alternada pela Amex | Reconfirmar 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ção | Nenhum arquivo GRRCN foi entregue no local ainda | Confirme 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ão | Apenas parte do conjunto de relatórios GRRCN foi configurada | Peça ao seu gerente de relacionamento para adicionar os relatórios GRRCN restantes à entrega diária |
| Uma conta de comerciante está totalmente ausente | Essa conta não está incluída nos relatórios GRRCN ou é entregue num local de SFT diferente | Peç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íveis | Esperado – a entrega é um lote diário | Aguarde o próximo arquivo diário. Não há caminho mais rápido neste conector |
Relacionado#
- Conectores Athia — o catálogo completo de conectores
- Integrando Athia — descartes de arquivos, compartilhamentos de warehouse e outros caminhos de integração
- Dicionário de dados Athia — definições de campo