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

PayPal direto

Nesta página

PayPal Direct é um conector de autoatendimento: um ID de cliente e um segredo, dois escopos de leitura e cinco configurações de API habilitadas no aplicativo. É a melhor fonte de disputas do catálogo e é um relatório resolvido, que molda o que você pode ou não pedir dele.

O que você ganha#

Transações liquidadas, saldos e pagamentos e registros de disputas com seu ciclo de vida.

Mais forte para disputas. Os dados de disputa do PayPal são mais completos do que a maioria, o que torna este o conector no qual se pode contar com a taxa de disputa por segmento, resultados de ganhos e perdas e o intervalo entre uma transação e a disputa que ela atrai. As disputas surgem 30 a 180 dias depois, e é por isso que um ano inteiro de história é importante aqui.

Mais fraco para análise de falha em nível de tentativa. A pesquisa de transação é um relatório liquidado - informa o que foi concluído, não o que foi tentado, portanto códigos de recusa por tentativa não estão disponíveis here.

Antes de começar#

Sua conta de comerciante deve ser ativado para pagamentos diretos. O uso ao vivo requer aprovação do PayPal – solicite-a antes de começar.

No console do PayPal, crie um Aplicativo API REST para Athia e observe seu Client ID e Segredo. Este é o caminho normal. As contas herdadas de pagamentos diretos usam NVP/SOAP credenciais - Nome de usuário, Senha e Assinatura.

Anexe exatamente dois escopos:

  • transactions:read
  • payouts:read

Esses dois escopos são somente leitura: esta credencial não pode capturar, reembolsar ou enviar dinheiro.

Habilite as configurações da API do aplicativo

As strings de escopo não controlam os dados por si só — as configurações da API do aplicativo fazem isso. Habilite todos os cinco no aplicativo:

Configuração do aplicativoO que isso bloqueia
Aceitar pagamentosPagamentos, autorizações, capturas, reembolsos
AssinaturasPlanos de cobrança e registros de assinatura
FaturamentoRegistros de fatura
Disputas de clientesDisputas e seu ciclo de vida
Pesquisa de transaçõesHistórico de transações liquidadas e saldos

Sem Faturamento e Assinaturas ativado, os dados da fatura e do plano de faturamento chegam vazios.

Crie uma função somente leitura

Faça login no Painel do desenvolvedor do PayPal como administrador e crie uma função personalizada – por exemplo Integração Athia — com permissões somente leitura para:

  1. Transações (pesquisa, detalhes)
  2. Relatórios (saldos, transações)
  3. Pagamentos (detalhes)
  4. Assinaturas
  5. Disputas

Produção e Sandbox são conexões separadas. Crie um aplicativo e uma conexão Athia para cada ambiente. Use credenciais ativas para a conexão de produção ou ela verifica e não carrega nada que você reconheça.

Credenciais que Athia pede#

CampoObrigatórioO que é / onde encontrar
NomeSimSeu rótulo para esta conexão – identifique a conta do comerciante do PayPal
CronogramaNãoCom que frequência Athia pesquisa o PayPal
ID do clienteSimDo aplicativo que você criou para Athia
Chave secretaSimO segredo correspondente para esse aplicativo
Nome de usuário / Senha / AssinaturaSomente legadoCredenciais NVP/SOAP — use-as em vez do ID do cliente e da chave secreta em contas herdadas de pagamentos diretos

Configurando a conexão#

  1. Crie o aplicativo, habilite as cinco configurações de API e confirme se ambos os escopos estão anexados.
  2. Em Configurações → Conexões, escolha + Adicionar conexão e selecione PayPal direto.
  3. Ativado Configurar conector, insira um Nome e escolha um Cronograma.
  4. Ativado Insira as credenciais, insira o ID do cliente e Chave secreta.
  5. Escolha Verifique a conexão.
  6. Copie o URL de destino do Webhook de Athia do assistente.
  7. No console do PayPal, vá para Meus aplicativos e credenciais → selecione seu aplicativo → Webhooks → Adicionar Webhook, cole o URL e selecione PAYMENT.CAPTURE.COMPLETED, DISPUTE.CREATED e PAYOUTS.BATCH.PROCESSED. Salve e ative o webhook.

A conexão então aparece como ACTIVE e a primeira sincronização começa. Para várias contas de comerciante do PayPal, crie um aplicativo e uma conexão para cada uma.

Cadência de sincronização#

Os relatórios estabelecidos recompensam menos a pesquisa frequente do que um conector de gateway, e a pesquisa mais rápida não produzirá detalhes de nível de tentativa que a fonte não carrega. Combine a programação com a frequência com que você realmente lê os dados.

Limites e coisas para saber#

  • Nenhum código de recusa por tentativa. A Pesquisa de transações relata atividades liquidadas; motivos de recusa de origem de um conector de gateway.
  • Os valores são decimais - nunca divida por 100.
  • Tempo de disputa. As disputas aparecem bem depois da transação, portanto as taxas de disputa do período recente sempre parecem melhores do que serão. Compare as coortes que tiveram tempo de amadurecer.
  • A história remonta a três anos. A Pesquisa de Transações retorna no máximo três anos de transações. Para qualquer coisa mais antiga, carregue arquivos - consulte 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
As transações chegam, mas nenhum pagamentopayouts:read não habilitadoAdicione o escopo e reconecte
Sem motivos de recusa em qualquer lugarEsperado – apenas relatórios liquidadosUse um conector em nível de gateway para dados de tentativa
A verificação falha logo após uma alteração de escopo ou permissãoNovas permissões ainda não aplicadasAguarde até nove horas e tente novamente – não emita novamente as credenciais
Os dados da fatura ou do plano de faturamento estão vaziosFaturamento ou Assinaturas não ativado no aplicativoAtive a configuração do aplicativo, aguarde a aplicação e reconecte
Nenhuma disputa ou evento de pagamento ocorre entre as pesquisasWebhook não registrado ou não habilitadoAdicione novamente o URL de destino do Athia Webhook em Meus aplicativos e credenciais → Webhooks e habilite-o
A taxa de disputa parece excepcionalmente baixaAs transações recentes não envelheceram em sua janela de disputaLeia a taxa de disputa em coortes maduras