Integrações e API
Conectar o Stripe
Para marcas que vendem por Payment Links, Checkout ou assinaturas no Stripe.
Nesta página
Antes de começar
No painel da marca (brand.bekrew.com), abra Configurações da marca → Integrações. Só o dono e os gestores conectam, testam e desconectam lojas.
Você precisa de acesso de administrador ou desenvolvedor na conta Stripe da marca.
Crie uma chave restrita
- 1No Stripe, abra Desenvolvedores → Chaves de API → Criar chave restrita.
- 2Dê estas permissões: Coupons (Write), Promotion Codes (Write), Checkout Sessions (Read), Invoices (Read), Charges (Read) e Webhook Endpoints (Write).
- 3Copie a chave, que começa com rk_live_ (produção) ou rk_test_ (teste).
- 4Na Krew, clique em Conectar no cartão do Stripe, cole a chave e confirme.
A Krew cadastra o webhook no Stripe sozinha. Você não precisa criar nenhum endpoint.
Link rastreado com Payment Link
Na aba Cupom da comunidade, use um Payment Link do Stripe como destino do link rastreado. A Krew abre o link com o cupom do creator já preenchido e com o clique no client_reference_id.
No Payment Link, ative a opção de permitir códigos promocionais. Sem ela, o cliente não consegue usar o cupom.
Quais vendas contam
- Pagamento único: o Checkout concluído e pago, inclusive Pix e boleto quando o pagamento é confirmado depois.
- Assinatura: cada fatura paga é uma venda do creator que trouxe o cliente, inclusive as renovações.
- Estorno: total ou parcial, a partir do reembolso da cobrança.
Depois de conectar
- 1Confira em Integrações se a conexão aparece como conectada e no ambiente certo (teste ou produção).
- 2Em cada comunidade, abra a aba Cupom e defina o desconto e o destino do link rastreado. A Krew cria um cupom por creator aprovado.
- 3Acompanhe o contador de cupons da conexão: ativos, pendentes e com erro. Pendente vira ativo em até um minuto.
- 4Faça uma compra de teste com o cupom de um creator e depois estorne. O pedido aparece em Vendas e o estorno ajusta a comissão.
Cupom pendente ou com erro
Confira a mensagem de erro em Integrações. O motivo mais comum é um código que já existe no Stripe: escolha outro código para o creator. Teste a conexão antes de sincronizar de novo.
A chave é confidencial. Não a coloque em páginas públicas, no código do navegador ou em mensagens.