Checkout.com

Checkout.com é um conector de autoatendimento e a fonte de custo mais forte do catálogo. Ele se baseia em duas coisas ao mesmo tempo: detalhes de pagamento do gateway e relatórios de reconciliação que decompõem o que cada transação realmente custou. Ative os relatórios primeiro ou você receberá metade dos pagamentos e nenhum custo pela metade.

O que você ganha#

Pagamentos e suas ações com resultados, disputas, pagamentos e detalhes de reconciliação cobrindo taxas e câmbio. As definições em nível de campo residem em Dicionário de dados Athia.

Mais forte para decomposição de taxas. De todos os provedores de cartão, Checkout.com divide os custos mais detalhadamente - taxas de intercâmbio, esquema, taxas de gateway, taxas de token de rede, taxas de estorno e FX chegam separadamente, o que torna o custo real por pedido aprovado possível, em vez de estimado.

Mais fraco para consistência de unidades. Os pagamentos vêm em unidades menores, os relatórios de reconciliação em decimais.

Antes de começar#

1. Habilite relatórios de reconciliação no Checkout.com lado. Até que sejam ativados, os dados de custo não aparecerão, independentemente do escopo da credencial.

2. Crie o par de chaves de acesso. No Hub, vá para Desenvolvedores → Chaves → Criar uma nova chave. A credencial é uma Access key ID mais uma Segredo da chave de acesso; Athia precisa de ambos.

3. Selecione Escopos Personalizados e o conjunto completo de escopos. Habilite no mínimo o gateway, vault e reports famílias de escopo. gateway:payment-details (detalhes de pagamento e ação) e reports:read (relatórios de reconciliação) devem ser incluídos, mas não são a lista completa — esse par não cobre os dados do relatório de saldo, pagamento e ação financeira que Athia ingere, e um conjunto de escopo restrito produz HTTP 401 erros em vez de dados parciais.

4. Selecione a entidade as tampas das teclas. O ID da entidade é o que separa a conexão de uma entidade da de outra.

5. Escolha o ambiente explicitamente. Um Teste mapas de contas para Ambiente de Teste; um Ao vivo mapas de contas para Produção. Uma chave do ambiente errado verifica e depois não carrega nada que você reconheça.

Credenciais que Athia pede#

Configurando a conexão#

1. Habilite relatórios de reconciliação, defina Permitir qualquer canal de processamento para ONe crie o par de chaves de acesso com Escopos personalizados e o escopo completo definido, para a entidade e o ambiente certos.
2. Em Configurações → Conexões, escolha + Adicionar conexão e selecione Checkout.com.
3. Ativado Configurar conector, insira um Nome e escolha um Cronograma.
4. Ativado Insira as credenciais, insira o ID da chave de acesso, Segredo da chave de acesso e ID da entidade.
5. Escolha Verifique a conexão.

A conexão então aparece como ACTIVE e a primeira sincronização começa. Se você opera várias entidades, crie uma conexão por entidade — ID da entidade é o que os separa.

Registre o webhook Athia#

Eventos de pagamentos e disputas chegam à Athia em tempo real através de um Checkout.com workflow.

1. No assistente de conexão, copie o URL de destino do Webhook de Athia.
2. No Hub, vá para Configurações → Fluxos de trabalho → Criar fluxo de trabalho.
3. Selecione os eventos payment_captured, payment_approved e dispute_created.
4. Adicione um Webhook ação e cole o URL de destino do Webhook de Athia.
5. Configure o cabeçalho da assinatura e teste, salve e ative o fluxo de trabalho.

Cadência de sincronização#

Esta conexão tem dois relógios: os detalhes do pagamento são atualizados à medida que as transações acontecem, enquanto os relatórios de reconciliação seguem Checkout.comciclo de relatórios mais lento. Os dados de custo não ficarão mais atualizados do que esse ciclo, seja qual for o cronograma escolhido.

Limites e coisas para saber#

• Unidades de quantidade mista. Os valores da API de pagamentos são unidades menores (dividir por 100); os valores do relatório de reconciliação são decimal. Athia normaliza na ingestão, mas verifique de qual fonte veio o valor antes de concluir que está errado.
• Os relatórios devem ser ativados primeiro, ou a decomposição de taxas em que esse conector é melhor não existe.
• O conjunto completo de escopo é necessário. Crie a chave com Escopos personalizados abrangendo pelo menos o gateway, vault e reports families. gateway:payment-details e reports:read por si só não cobrem dados de relatórios de saldo, pagamentos e ações financeiras, e um conjunto de escopo restrito retorna HTTP 401 em vez de dados parciais.
• Os dados do cartão são minimizados.

Solução de problemas#

Relacionado#

Outros provedores e caminhos de ingestão estão listados em Conectores Athia. Para descartes de arquivos e alternativas de armazém para armazém para um conector direto, consulte Integrando Athia.