Mundopay
Nesta página
Worldpay é baseado em arquivo, não em API. Você agenda Relatórios Seguros Programados (SSR) para ser entregue diariamente como .CSV à sua conta FTP do comerciante, e Athia se conecta a essa conta diariamente para baixar, analisar e mapear os relatórios. Não há pesquisa de API nem webhook. Os pré-requisitos do lado do provedor são um esforço conjunto: sua equipe Athia informa quais relatórios agendar e fornece os endereços IP para a lista de permissões, e você configura os Relatórios Seguros Programados e a lista de permissões em seu próprio painel do Worldpay, porque somente você tem acesso a eles. Assim que os relatórios chegarem à sua conta FTP e a lista de permissões estiver em vigor, você mesmo conclui a conexão.
O que você ganha#
Cada relatório é agendado separadamente no SSR, tudo em .CSV.
| Relatório | Cadência | O que isso carrega |
|---|---|---|
| Relatório de sessão | Diariamente | Reconciliação de transações |
| Relatório de transações recusadas | Diariamente | Transações diferidas, recusadas e duplicadas |
| Relatório de solicitações de plano recusadas | Diariamente | Planos recorrentes recusados |
| Relatório financeiro de estorno | Diariamente | Estornos e ajustes |
| Relatório de status de estorno | Diariamente / mensalmente | Atividade de estorno |
| Relatório de ganhos/perdas de estorno | Diariamente | Casos ganhos e perdidos |
| Relatório de insights do emissor | Semanalmente, sexta-feira | Dados da semana anterior |
| Relatório de vendas líquidas liquidadas por transação | Diariamente | Transações liquidadas por atividade e data de liquidação |
| Relatórios de atividades e liquidação | Diariamente / mensalmente | Finanças resumidas por atividade e data de liquidação |
| Relatório de taxas | Diariamente / mensalmente | Worldpay e taxas de repasse por atividade e data de liquidação |
| Relatório de taxas de rede de adquirente fixa Visa | Mensalmente, no dia 8 | Taxas FANF do mês anterior |
| Relatório EMDR | Diariamente | Transações canadenses, três dias antes |
Antes de começar#
- Acesso a uma conta Worldpay com permissão para configurar Relatórios Seguros Programados (SSR) e gerenciar contas de FTP de comerciantes.
- Os relatórios acima programados no SSR, em
.CSV, entregue em sua conta FTP do comerciante. O Guia de Referência SSR da Worldpay cobre os detalhes de cada relatório em nível de campo. - Os detalhes da sua conta FTP comercial em mãos - nome da conta, host, porta, nome de usuário e senha.
- Os endereços IP de Athia são permitidos se sua conta exigir isso.
Athia impõe SFTP/FTPS. Um endpoint FTP simples não será aceito.
Credenciais que Athia pede#
| Campo | Obrigatório | O que é / onde encontrar |
|---|---|---|
| Nome | Sim | Seu rótulo para esta conexão — identifique a conta do comerciante Worldpay |
| Nome da conta FTP | Sim | O SSR da conta FTP do comerciante entrega para |
| URL/Hospedeiro | Sim | O host FTP ao qual Athia se conecta, por SFTP ou FTPS |
| Porto | Sim | A porta para esse host |
| Nome de usuário | Sim | O nome de usuário da conta FTP |
| Senha | Sim | A senha correspondente |
Configurando a conexão#
- Pergunte à sua equipe Athia quais relatórios agendar e, em seguida, no painel do Worldpay, abra o Relatórios Seguros Programados (SSR) atendimento e agendá-los, em
.CSV, para sua conta FTP do comerciante. - Configure ou recupere os detalhes da conta FTP do comerciante — Nome da conta FTP, URL/Hospedeiro, Porto, Nome de usuário, Senha.
- Peça à sua equipe Athia os endereços IP atuais da Athia e coloque-os na lista de permissões se o Worldpay exigir.
- Em Athia, vá para Configurações → Conexões → + Adicionar conexão e selecione Mundopay.
- Ativado Configurar conector, insira um Nome. Não há Cronograma field.
- Ativado Insira as credenciais, insira o nome da conta FTP, host, porta, nome de usuário e senha.
- Escolha Verifique a conexão. Athia executa um ping FTP e recupera um arquivo de amostra.
A conexão então aparece como ACTIVE e a primeira sincronização começa. Para diversas contas de comerciante, agende os relatórios para cada uma e crie uma conexão por conta com seus próprios detalhes de FTP.
Webhook#
Worldpay não usa webhooks. Os relatórios chegam como arquivos na sua conta FTP, portanto não há URL de destino para registrar e nenhuma seleção de evento a ser feita. Se webhooks baseados em API estiverem habilitados em sua conta, converse com sua equipe Athia.
Cadência de sincronização#
A programação é fixada diariamente - não há Cronograma campo para escolher. Athia se conecta à conta FTP uma vez por dia e processa tudo o que o SSR entregou.
Limites e coisas para saber#
- Você só recebe o que programou. Um relatório que você não configurou no SSR simplesmente está ausente — não há API para recorrer.
- A cadência do relatório é da Worldpay, não sua. O Issuer Insights chega semanalmente na sexta-feira, o FANF mensalmente no dia 8 e o EMDR traz dados dos três dias anteriores. Leia essas séries em seu próprio relógio.
- Somente SFTP/FTPS. Athia recusa FTP simples.
- A lista de permissões de IP é um pré-requisito, não uma solução. Se sua conta aplicar isso, a verificação falhará até que a lista de permissões esteja em vigor.
- Uma conexão por conta de comerciante, cada um com seus próprios detalhes de FTP.
- 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 com acesso negado | IPs de Athia não permitidos ou nome de usuário ou senha de FTP incorretos | Obtenha a lista de IP atual da sua equipe Athia, coloque-a na lista de permissões e verifique novamente as credenciais |
| A verificação falha no host ou na porta | O endpoint é FTP simples ou a porta está errada para SFTP/FTPS | Forneça um endpoint SFTP ou FTPS e sua porta |
A conexão é ACTIVE mas nenhum dado após a primeira sincronização | Nenhum relatório agendado ainda ou o SSR é entregue em uma conta FTP diferente | Confirmar no SSR que os relatórios estão agendados, em .CSV, para a conta à qual Athia se conecta |
| Alguns tipos de relatório estão faltando | Esses relatórios nunca foram agendados no SSR | Adicione-os no SSR; eles aparecem na próxima entrega diária |
| Valores de estorno ou taxas ficam atrasados em relação às transações | Esperado – esses relatórios são executados em sua própria cadência | Reconcilie estornos e taxas na data de liquidação, não na data da atividade |
| Os dados param de chegar para uma conta de comerciante | A senha do FTP dessa conta foi alterada ou seus relatórios não foram programados | Atualize a credencial nessa conexão e confirme suas programações de SSR |
Relacionado#
- Conectores Athia — o catálogo completo de conectores
- Dicionário de dados Athia — definições de campo
- Integrando Athia — descartes de arquivos, compartilhamentos de warehouse e outros caminhos de integração