Integrar a Stripe ao Kubo para uso no Marketplace

Para utilizar a Stripe como meio de pagamento no Marketplace, é necessário integrá-la ao Kubo.

Pré-requisitos

Antes de iniciar, verifique se:

• Sua empresa possui uma conta ativa na Stripe.

• O cadastro da conta está completo e aprovado.

• O ambiente de produção está ativado.

Instruções

Passo 1: obter as credenciais Stripe Key e Stripe Secret

1. Acesse o painel da Stripe (Dashboard) com seu login

2. Acesse Desenvolvedores > Chaves de API

3. Desative o Modo de teste e certifique-se de estar no ambiente de Produção

4. Copie a Chave publicável, que começa com pk_live_

5. Copie a Chave secreta, que começa com sk_live_
   Se necessário, clique para revelá-la.

Passo 2: configurar as credenciais Stripe Key e Stripe Secret no Kubo

1. Acesse o menu Marketplace > Configuração

2. Clique na aba Pagamento

3. Em Meio de pagamento, habilite a opção Ativar da Stripe

4. Preencha os campos Stripe Key e Stripe Secret com as credenciais obtidas no Passo 1

5. Clique no botão Salvar

Passo 3: configurar a URL de notificações (Webhook)

1. Acesse o menu Marketplace > Configuração

2. Clique na aba Pagamento

3. Em Meio de pagamento > Stripe, copie a URL exibida no campo Webhook

4. Acesse o painel da Stripe

5. Acesse Desenvolvedores > Webhooks

6. Clique em Adicionar endpoint

7. No campo URL do endpoint, cole a URL copiada do Kubo no passo 3

8. Em Selecionar eventos para ouvir, selecione os eventos de cobrança e pagamento (charge.succeeded, charge.failed, payment_intent.succeeded, etc)

9. Clique em Adicionar endpoint para salvar

Passo 4: testar a integração

1. Gere uma transação de teste via cartão de crédito, com valor mínimo de R$ 1,00, na plataforma

2. Verifique se o status da compra no Kubo foi atualizado automaticamente para Pago

Esse teste permite validar se a integração está funcionando corretamente e se a baixa dos pagamentos ocorre de forma automática.

Last updated: August 06, 2026