Listra
Nesta página
Uma única chave de API restrita fornece ao Athia suas atividades no Stripe de ponta a ponta: cobranças, aprovações e recusas, reembolsos e disputas, e o que o Stripe resolveu e cobrou de você.
O que você ganha#
Pagamentos e tentativas de pagamento com seus resultados, reembolsos, disputas e taxas registradas em cada transação.
Mais forte em termos de amplitude de uma credencial. Uma chave restrita cobre todos os domínios — não há relatórios para ativar primeiro, o que torna este o conector mais rápido de ser implementado.
Mais fraco em termos de granularidade de custos. As taxas chegam misturado, portanto, o intercâmbio não pode ser separado dos componentes do esquema e do gateway. Para trabalho em nível de intercâmbio, adicione Adyen ou Checkout.com data.
Antes de começar#
A versão API da sua conta Stripe deve ser 19/02/2019 ou posterior.
Crie um chave de API restrita (rk_…) para Athia no console Stripe — não sua chave secreta padrão:
- Acessar Desenvolvedores → Chaves de API e escolha Criar chave restrita.
- Escolha Construindo sua própria integração e continuar.
- Dê um nome à chave — por exemplo,
Athia Integration. - Defina as permissões abaixo.
- Crie a chave e copie o token.
| Acesso | Recursos |
|---|---|
| Leia | Saldo, fontes de transação de saldo, transferências de saldo, cobranças, disputas, eventos, arquivos, PaymentIntents, PaymentMethods, pagamentos, produtos, SetupIntents, fontes, tokens, notas de crédito, assinaturas, SKUs, execuções de relatórios, tipos de relatórios. Se você usar contas conectadas, conceda também leitura nos recursos do Connect, incluindo links de contas. |
| Escreva | Terminais de webhook |
Três bolsas são fáceis de perder. Um interrompe a conexão; os outros dois falham silenciosamente.
| Conceder | Omita e |
|---|---|
| Leia ligado Eventos | A conexão falha completamente. |
| Leia em relatórios - Execuções de relatórios e Tipos de relatório | Os dados das taxas do cartão no nível da transação não estão disponíveis, sem causa óbvia. |
| Leia nos recursos do Connect, incluindo Links de conta | Os dados da conta conectada não podem ser selecionados. |
Credenciais que Athia pede#
| Campo | Obrigatório | O que é / onde encontrar |
|---|---|---|
| Nome | Sim | Seu rótulo para esta conexão – identifique a conta Stripe que ela cobre |
| Cronograma | Não | Com que frequência Athia pesquisa Stripe |
| Chave de API | Sim | A chave restrita criada acima |
| Período de sincronização histórica | Sim | Todos os tempos ou Limite de data - até que ponto o aterro chega |
| Limite de sincronização reversa | Com Limite de data | A primeira data em que o preenchimento atinge |
Configurando a conexão#
- Em Configurações → Conexões, escolha + Adicionar conexão e selecione Listra.
- Ativado Configurar conector, insira um Nome e escolha um Cronograma.
- Ativado Insira as credenciais, cole a chave em Chave de API, escolha um Período de sincronização históricae defina o Limite de sincronização reversa data se Limite de data revela um.
- Escolha Verifique a conexão.
- Copie o URL de destino do Webhook de Athia mostrado no assistente.
- No Stripe, vá para Desenvolvedores → Webhooks → Adicionar endpoint, cole esse URL e selecione os eventos
charge.succeeded,dispute.createdepayout.paid. Teste, salve e habilite o endpoint.
A conexão então aparece como ACTIVE e a primeira sincronização começa. Para cada conta Stripe adicional – incluindo Contas conectadas — crie uma chave restrita separada e uma conexão separada.
Cadência de sincronização#
Escolha um Cronograma isso corresponde ao quão atentamente você observa a aceitação. A pesquisa mais rápida não melhora os registros de pagamentos e taxas, que mudam apenas quando o Stripe é liquidado.
Limites e coisas para saber#
- A sincronização histórica é limitada a um ano. Todos os tempos preenche o ano inteiro que Athia pode alcançar; Limite de data leva um Limite de sincronização reversa data, que não pode ser anterior a um ano antes de hoje. Para histórico mais antigo, carregue-o por meio de um depósito seguro de arquivos (SFTP/S3) — consulte Integrando Athia.
- As taxas são combinadas. O intercâmbio granular não está disponível através deste conector.
- Os valores são unidades menores — divida por 100. Athia cuida disso na ingestão; isso é importante na hora de conciliar uma exportação bruta do Stripe.
- Os dados do cartão são minimizados. Para saber o que cada campo ingerido contém, consulte Dicionário de dados Athia.
Solução de problemas#
| O que você vê | Causa provável | O que fazer |
|---|---|---|
| A verificação foi bem-sucedida, mas um domínio está vazio | Leitura ausente nesse recurso | Edite as permissões da chave e reconecte |
| Menos história do que o esperado | O limite de um ano | Carregue o histórico antigo por meio de um descarte seguro de arquivos |
Relacionado#
- Conectores Athia — o catálogo completo de conectores.
- Integrando Athia — caminhos de integração, incluindo descarte de arquivos e depósito para depósito.
- Dicionário de dados Athia — definições em nível de campo.