Pular para o conteúdo principal

Stripe

Instruções para conectar o Stripe​

Crie uma conta de pagamento do tipo Stripe​

Como criar uma conta de pagamento está descrito aqui (abre em uma nova aba).

Conecte o Stripe à conta de pagamento​

Para isso, vá até a conta de pagamento criada e clique em Conectar Stripe.

Formulário de edição da conta de pagamento stripe, uma seta aponta para o botão "Connect Stripe" abaixo da caixa "Test mode"

Você será redirecionado para a página de conexão do Stripe. Preencha os dados da empresa, escolha o tipo e a localização do negócio, confirme o representante da conta e forneça os dados bancários para os pagamentos. Após concluir o registro, você retornará ao CMS, e a conta de pagamento exibirá o status Stripe conectado.

Após a conexão, vá para Desenvolvedores → Webhooks no Painel do Stripe e clique em Adicionar destino.

Siga os passos do assistente de criação de destino de evento: escolha os eventos a serem monitorados, selecione o tipo de destino (endpoint de webhook) e, na etapa de configuração, no campo Endpoint URL, insira o endereço do nosso webhook. Substitua test-project.oneentry.cloud pelo endereço do seu projeto:

https://test-project.oneentry.cloud/api/content/payments/webhook/stripe

Defina um nome para o destino e conclua a criação — o novo endpoint aparecerá na lista de Destinos de eventos com o status Ativo.

Para que o OneEntry verifique a autenticidade dos eventos recebidos do Stripe, copie o segredo de assinatura (Signing secret) do endpoint criado no Painel do Stripe. Ele será necessário nas configurações da conta de pagamento.

Após adicionar o webhook, vá para o CMS em Pagamentos → Status, selecione o repositório de pedidos e acesse suas configurações.

Aba "Statuses" de "Payments": a tabela mostra "Order Storage 1" com o marcador storage1 e um ícone de configurações

Adicione a atualização automática do status de pagamento para o pedido. À esquerda estão os status de pagamento, e à direita os status dos seus pedidos, adicionados anteriormente na seção de pedidos: escolha qual status o pedido recebe para cada status de pagamento.

Tela "Payment Status Settings": status de pagamento "Waiting", "Completed", "Canceled", "Payment has expired" associados aos status do pedido, botão "Save"

Preencha as configurações da conta​

Abra a conta de pagamento para edição. No bloco Detalhes, informe:

  • Success URL — endereço para o qual o comprador retornará após um pagamento bem-sucedido. Este campo é obrigatório.
  • Cancel URL — endereço para o qual o comprador retornará em caso de cancelamento do pagamento.
  • Session timeout — tempo de vida da sessão de pagamento. O valor deve ser um número inteiro maior que 0.
  • Use Stripe webhook data validation — ativa a verificação da autenticidade dos dados que o Stripe envia para o webhook.
  • Key for validating Stripe webhook — segredo de assinatura do endpoint do Painel do Stripe. Este campo se torna disponível apenas quando a opção Use Stripe webhook data validation está marcada, e nesse caso é obrigatório.

As alterações são salvas automaticamente.

Bloco "Details" da conta de pagamento stripe: uma seta aponta para os campos "Success URL" e "Cancel URL"

Na conta de pagamento, há suporte para o modo de teste. Esta função permite testar a conexão do Stripe com parâmetros de conexão de teste.

Conta de pagamento stripe: uma seta aponta para a caixa "Testing mode" desmarcada acima do botão "Connect Stripe"

Para desativar o modo de teste, desmarque a opção.