Como conectar o Stripe

Com o Stripe, o cliente paga dentro da loja, em um formulário do próprio Stripe com o visual da sua marca. Você só precisa colar duas chaves da sua conta: a UnaShop valida na hora e cria o webhook (o aviso automático de pagamento) sozinha. A tela é do administrador da loja, ou de um usuário com a permissão de pagamentos.

Antes de começar

• Tenha uma conta no Stripe e consiga entrar no Dashboard do Stripe.
• Para receber de verdade, a conta Stripe precisa estar liberada para pagamentos reais. Para testar, as chaves de teste já bastam.
• Se quiser Pix e boleto, ative esses métodos no seu painel do Stripe. A loja mostra os métodos que estiverem ativos lá.

Passo a passo

1. 1

   Abra o painel do Stripe

   Em Configurações e Pagamentos, na seção Escolha como receber, clique no cartão do Stripe. O painel lateral abre na etapa Conectar.

2. 2

   Pegue as chaves

   No bloco Onde encontro?, clique em Abrir o Dashboard do Stripe. No Stripe, vá em Desenvolvedores e Chaves de API. Copie a chave publicável (começa com pk_) e revele e copie a chave secreta (começa com sk_). Se preferir, use uma chave restrita (começa com rk_).

3. 3

   Cole a chave publicável

   Cole no campo Chave publicável. Ao lado do nome aparece Chave de teste ou Chave de produção, conforme a chave.

4. 4

   Cole a chave secreta

   Cole no campo Chave secreta. As duas chaves precisam ser do mesmo modo: pk_test com sk_test, ou pk_live com sk_live.

5. 5

   Conecte

   Clique em Conectar Stripe. Enquanto aparece Verificando com o Stripe, a UnaShop confere as chaves e cria o webhook na sua conta.

6. 6

   Confira a verificação

   Na etapa Verificar, veja Conta conectada (nome, e-mail e país da conta), Webhook configurado automaticamente e o modo (Modo de teste ou Modo de produção).

7. 7

   Ative

   Clique em Continuar para ativar e depois em Usar Stripe para receber. Ao ver a confirmação, clique em Concluir.

Usando chave restrita

A chave restrita é uma chave com permissões limitadas, mais segura. Ela precisa de permissão de escrita em PaymentIntents e Webhook Endpoints e de leitura em Account, Charges e Disputes. Se faltar alguma, o painel avisa qual é.

Como fica na loja

No checkout, o cliente vê o formulário do Stripe dentro da página e paga com os métodos ativos na sua conta. Pagamento de cartão aprovado vira pedido pago na hora. Pix e boleto ficam pendentes até o Stripe avisar, pelo webhook, que o dinheiro entrou.

Trocar ou desconectar

Para trocar as chaves, abra o Stripe em Pagamentos, clique em Editar credenciais e use o botão Trocar na chave secreta salva. Para tirar as chaves da loja, use Desconectar Stripe na etapa Verificar. Esse botão fica travado enquanto o Stripe for o gateway ativo: ative outro antes.