Pular para o conteúdo principal
Todos os sistemas operacionaisNovidadesv1
Entrar

Perseguir

Nesta página

Chase é a empresa de aquisição de comerciantes e processamento de pagamentos do JP Morgan Chase – seu portal de desenvolvedores e documentação usam o nome JP Morgan Chase. Os dados chegam ao Athia de três maneiras: o Athia pesquisa as APIs de pagamentos globais e relatórios para status e relatórios de pagamentos, recebe pushes no webhook que você registra no portal JPMC e coleta arquivos em lote SFTP onde a integração é baseada em formulário. Os pré-requisitos do lado do provedor – acesso à API no JP Morgan Chase Payments Developer Portal e qualquer formulário DFR que deva ser enviado ao seu gerente de relacionamento JPMC – são organizados com sua equipe Athia. Depois de possuir as credenciais, você mesmo conclui a conexão.

O que você ganha#

  • Pagamentos — status e informações de pagamento em tempo real.
  • Transações — detalhes e saldos das transações.
  • Relatórios — vendas, reembolsos, depósitos e taxas, pré-financiados e pós-financiados.
  • Notificações — eventos e recomendações.

Os relatórios personalizados são definidos por meio de parâmetros de API ou por meio de um formulário DFR em que o relatório necessário não é aquele retornado pelas APIs.

Antes de começar#

Você precisa de acesso ao Portal do desenvolvedor de pagamentos do JP Morgan Chase com permissão para gerar certificados, credenciais OAuth ou chaves de API.

No portal:

  1. Solicite ou configure o acesso ao Pagamentos globais e Relatórios APIs.
  2. Habilite os recursos necessários, por exemplo, pagamentos e notificações em tempo real.
  3. Gere a credencial que Athia usará.

Escolha um tipo de credencial

Qualquer um funciona:

  • OAuth — gerar um ID de cliente e um segredo e definir os escopos payments:read e reports:read. Ambos os escopos são somente leitura: esta credencial não pode movimentar dinheiro.
  • Baseado em certificado - baixe o .pem / .crt arquivos do portal e carregue-os no Athia.

Associe a credencial ao seu tipo de entidade — Empresa ou Unidade de negócios.

O formulário DFR

Relatórios adicionais requerem um DFR (relatório de arquivo delimitado) formulário. Ele pede Nome comercial e Número da entidadee você envia por e-mail o formulário preenchido para seu Gerente de Relacionamento JPMC. Entre em contato com a equipe de conta da Athia se desejar ajuda com os formulários DFR ou com a configuração inicial.

Credenciais que Athia pede#

CampoObrigatórioO que é / onde encontrar
NomeSimSeu rótulo para esta conexão – identifique a entidade Chase que ela cobre
CronogramaSimCom que frequência Athia pesquisa Chase – diariamente ou de hora em hora
ID do cliente OAuthSomente OAuthDa credencial OAuth gerada no portal JPMC
Segredo do cliente OAuthSomente OAuthThe matching secret for that client ID
Carregamento de certificadoSomente certificadoO .pem / .crt arquivos baixados do portal — use-os em vez do par OAuth
Número da entidadeSimSeu identificador de entidade JPMC, o mesmo número usado no formulário DFR

Configurando a conexão#

  1. No portal JPMC, confirme o acesso à API, habilite os recursos necessários e gere o par OAuth com payments:read e reports:read ou os arquivos de certificado.
  2. Em Athia, vá para Configurações → Conexões → + Adicionar conexão e selecione Perseguir.
  3. Ativado Configurar conector, insira um Nome e escolha um Cronograma.
  4. Ativado Insira as credenciais, insira o ID do cliente OAuth e Segredo do cliente OAuthou carregue o .pem / .crt arquivos e digite seu Número da entidade.
  5. Defina a rede e a operação — selecione ou crie um grupo e adicione as operações que esta conexão cobre.
  6. Escolha Verifique a conexão. Athia executa um ping leve de status de pagamento na API.
  7. Copie o URL de destino do Webhook de Athia do assistente e registre-o no portal JPMC - veja abaixo.

A conexão então aparece como ACTIVE e a primeira sincronização começa. Para diversas entidades, gere um certificado separado ou use subIDs e crie uma conexão por entidade.

Webhook#

Registre Athia como destino de notificação para que as alterações no status do pagamento cheguem no momento em que acontecem, e não na próxima votação.

  1. Copie o URL de destino do Webhook de Athia no assistente de conexão.
  2. No Portal do desenvolvedor do JP Morgan Chase Payments, abra a configuração de notificações/webhook.
  3. Cole o URL do Athia e selecione os eventos desejados — alterações no status do pagamento, além de atualizações e recomendações de pagamento, caso você as use.
  4. Habilite o webhook e teste a configuração no portal.

Pule isso e Athia verá apenas o que a enquete agendada retorna.

Cadência de sincronização#

Diariamente ou de hora em hora. Onde sua integração é baseada em formulário e não em API, os mesmos dados chegam Lote SFTP arquivos em vez de pesquisas de API.

Limites e coisas para saber#

  • O número da entidade é obrigatório. Sem ele, a conexão não pode ter como escopo a entidade JPMC correta.
  • Uma credencial por entidade. Certificados ou subIDs separados e uma conexão Athia separada para cada um.
  • Os formulários DFR são encaminhados pelo seu Gerenciador de Relacionamento. Aguarde o tempo de espera antes que os relatórios que eles desbloqueiam apareçam.
  • Os ambientes de produção e teste são separados. Use credenciais de produção na conexão em que você espera os dados de produção.
  • 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 upload de um certificadoArquivo errado exportado ou o certificado não é o associado a esta entidadeBaixe novamente o .pem / .crt do portal JPMC e carregue novamente
A verificação falha no OAuthEscopos ausentes no clienteAdicionar payments:read e reports:read no portal e verifique novamente
Os pagamentos chegam, mas os relatórios estão vaziosAcesso à API de relatórios não concedido ou o relatório precisa de um formulário DFRSolicitar acesso à API Reporting no portal; para relatórios adicionais, envie o formulário DFR por e-mail para seu gerente de relacionamento
A conexão é ACTIVE mas os dados pertencem a outra entidadeErrado Número da entidade na conexãoCorrija o número da entidade e verifique novamente
Nada chega entre as pesquisasWebhook não cadastrado ou não habilitado no portalAdicione novamente o URL de destino do Webhook de Athia, selecione eventos de alteração de status de pagamento e ative-os
Nenhum dado após a primeira sincronizaçãoCredenciais do ambiente de teste em uma conexão de produçãoEmita novamente as credenciais no ambiente em que você processa e reconecte