Para utilizar o Asaas como meio de pagamento no Marketplace, é necessário integrá-lo ao Kubo.
Pré-requisitos
Antes de iniciar, verifique se:
-
Sua empresa possui uma conta ativa no Asaas.
-
O cadastro da conta está completo.
-
Os documentos da empresa foram aprovados.
-
A conta bancária para saque está validada.
Instruções
Passo 1: obter a chave de API do Asaas
-
Acesse o painel do Asaas com seu login
-
Clique no ícone de engrenagem, localizado no canto superior direito
-
Acesse o menu Integrações
-
Localize a seção Gerar API Key ou Chave de API
-
Copie a Chave de API (access token) gerada
Armazene essa credencial em local seguro e nunca a compartilhe publicamente.
Passo 2: configurar a chave de API no Kubo
-
Acesse o menu Marketplace > Configuração
-
Clique na aba Pagamento
-
Em Meio de pagamento, habilite a opção Ativar do Asaas
-
Preencha o campo Chave API com a credencial obtida no Passo 1
Para orientações sobre os demais campos de configuração, acesse Configurar pagamento.
-
Clique no botão Salvar
Passo 3: configurar a URL de notificações (Webhook)
-
Acesse Marketplace > Configuração
-
Clique na aba Pagamento
-
Em Meio de pagamento > Asaas, copie a URL exibida no campo Webhook
-
Acesse o painel do Asaas
-
Acesse Configurações > Integrações
-
Localize a área Webhooks e configure um novo webhook
-
No campo URL, cole a URL copiada do Kubo no passo 3
-
Na fila de eventos, marque as opções relacionadas às atualizações de status (Pagamento Recebido, Pagamento Atrasado, etc)
-
Salve as configurações no Asaas
Passo 4: testar a integração
-
Gere uma transação de teste via cartão de crédito ou PIX, com valor mínimo de R$ 1,00, na plataforma
-
Efetue o pagamento
-
Verifique se o status do pedido no Kubo foi atualizado para Pago em poucos instantes
Esse teste permite validar se a integração está funcionando corretamente e se a baixa dos pagamentos ocorre de forma automática.