Conectar a Checkout.com
Receba com cartão de crédito e débito pela sua conta Checkout.com, com assinaturas, order bump e upsell de 1 clique.
A Checkout.com processa cartões de crédito e débito para contas abertas em cerca de 60 países da Europa, das Américas, do Oriente Médio e da Ásia-Pacífico. Conectada ao Vipter, ela atende vendas avulsas, assinaturas, order bump e upsell de 1 clique. A Checkout.com não faz PIX nem parcelamento pelo Vipter.
Antes de começar
- Uma conta Checkout.com. Para experimentar antes, uma conta sandbox serve.
- Acesso ao painel da Checkout.com com permissão para criar chaves de API e webhooks.
- Papel Admin ou Dono no projeto do Vipter.
- Espaço no seu plano para mais uma conexão ativa. A tela de provedores mostra quantas você já usa.
Passo 1: copiar os dados da conta na Checkout.com
O Vipter pede três dados da sua conta. Copie os três do mesmo ambiente: todos do sandbox para testar, ou todos de produção para vender.
- Chave secreta: no painel da Checkout.com, abra DevelopersKeys e crie uma chave de API. A chave secreta do sandbox começa com
sk_sbox_e a de produção comsk_. Ela só aparece uma vez: copie na hora. - ID do canal de processamento: abra SettingsProcessing channels e copie o ID do canal que vai receber as vendas. Ele começa com
pc_. - Prefixo do subdomínio: em DevelopersOverview, a URL da API da sua conta tem o formato
https://abcd1234.api.checkout.com(.api.sandbox.checkout.comno sandbox). O prefixo são os 8 caracteres antes de.api.
Guarde a chave com cuidado
A chave secreta dá acesso total à sua conta Checkout.com. Cole a chave só no Vipter. Se ela vazar, revogue a chave na Checkout.com, crie outra e troque no Vipter pelo botão Trocar chaves.
Passo 2: criar a conexão no Vipter
- No painel do Vipter, abra PagamentosProvedoresCheckout.com.
- Clique em Nova conexão. Se a loja ainda não tem nenhuma conta Checkout.com, o formulário já aparece aberto.
- Preencha os campos:
| # | Campo | O que colar |
|---|---|---|
| 1 | Nome da conta | Um nome para reconhecer a conta, como "Checkout.com Europa". Ele aparece nos fluxos de pagamento. |
| 2 | País da conta | O país onde a conta Checkout.com foi aberta. Não dá para mudar depois. |
| 3 | Chave secreta (Secret key) | A chave secreta que você copiou no passo 1 (sk_sbox_ ou sk_). |
| 4 | ID do canal de processamento (Processing channel ID) | O ID do canal de processamento, que começa com pc_. |
| 5 | Prefixo do subdomínio da API | Os 8 caracteres antes de .api na URL da API da sua conta, só letras minúsculas e números. |
| 6 | Conexão de teste | Ligado, aceita só a chave do sandbox (sk_sbox_). Desligue para cobrar de verdade com a chave de produção. |
- Clique em Salvar e obter a URL de webhook. O Vipter confere os dados com a Checkout.com antes de salvar. Se algum estiver errado, nada é gravado e o erro aparece no formulário.
O modo de teste vem ligado
O botão Conexão de teste começa ligado para que a primeira conexão não cobre ninguém por engano. Para vender, crie a conexão com ele desligado e a chave de produção.
Se esta for a primeira conta de cartão da loja, o Vipter cria sozinho os fluxos de pagamento de cartão de crédito e de débito apontando para ela. A loja já pode cobrar depois do passo 4.
Passo 3: cadastrar o webhook na Checkout.com
Pelo webhook, a Checkout.com avisa o Vipter do que acontece depois da compra, como pagamentos confirmados, reembolsos e contestações. Cada aviso vem assinado com uma chave que você define no webhook, e o Vipter recusa os avisos até ter essa chave.
- Depois de salvar, o card da conexão mostra a URL do webhook. Copie o endereço.
- Na Checkout.com, abra DevelopersWebhooks e crie um webhook novo.
- Cole a URL copiada no item 1 e selecione os eventos de pagamento.
- Gere ou defina a Signature key do webhook, copie o valor e salve o webhook.
- Volte ao Vipter, cole a chave no card da conexão e clique em Salvar segredo.
| # | Campo | O que colar |
|---|---|---|
| 1 | Chave de assinatura do webhook (Signature key) | A Signature key do webhook que você criou na Checkout.com. |
Passo 4: testar a conexão
- No card da conexão, clique em Testar. O Vipter consulta a Checkout.com com os dados salvos.
- Faça uma compra de teste no checkout de uma oferta, com um dos cartões de teste da documentação da Checkout.com (página Test cards).
Deu certo se
Aparece a mensagem Conexão OK. e a compra de teste entra em VendasTransações como paga.
Problemas comuns
-
Seu plano permite N conector(es) ativo(s). Faça upgrade para adicionar mais.
O plano chegou ao limite de conexões ativas. Desative uma conexão que não usa mais ou mude de plano em Plano Vipter.
-
Valor inválido
Um dos três dados não tem o formato da Checkout.com: a chave começa com
sk_, o canal compc_e o prefixo tem exatamente 8 letras minúsculas ou números, semhttps://nem pontos. -
A Checkout.com recusou a chave
A chave é de outro ambiente: uma chave
sk_sbox_só funciona com o modo de teste ligado, e uma de produção só com ele desligado. Confira também se o prefixo e o canal são da mesma conta e do mesmo ambiente da chave. -
Pagamentos confirmados na Checkout.com não mudam de status no Vipter
O webhook não foi cadastrado ou a Signature key salva no Vipter não é a do webhook. Confira os dois e salve a chave de novo no card da conexão.
O que fazer a seguir
- Revise os fluxos de pagamento para decidir qual conta cobra cada pagamento e qual serve de reserva.
- Veja como funcionam os pagamentos para comparar a Checkout.com com os outros provedores.