Docs

Pagamentos

Conectar Stripe

Os compradores pagam sua própria conta Stripe. Criamos cada checkout nela e escutamos os eventos do Stripe. Nunca ficamos com o dinheiro nem vemos um número de cartão.

Conecte sua conta

  1. Abra Pagamentos. Em Pagamentos, na seção Stripe, escolha Conectar no lado Teste e diga se você tem uma conta Stripe.
  2. Conclua o cadastro do Stripe. As páginas do próprio Stripe abrem. Elas criam uma conta conectada para seus apps e podem copiar seus dados verificados de uma conta Stripe que você já tem.
  3. Confira se está conectado. De volta em Pagamentos, o lado Teste mostra Conectado, com o nome e o ID da conta.
  4. Conecte a conta real ao entrar em produção. Faça o mesmo no lado Produção quando estiver pronto para receber dinheiro de verdade.
  • Uma conexão serve para todos os seus apps.
  • Teste e produção se conectam separadamente.
  • Conectar ou desconectar pede que você confirme de novo que é você se entrou há mais de 10 minutos.
  • Desconectar a produção interrompe novos checkouts do Stripe até você reconectar. Relógios que pagaram continuam desbloqueados.

Ou use sua própria chave

Escolha Usar minha própria chave e cole uma chave restrita com leitura e escrita em Checkout Sessions, e leitura em cobranças e reembolsos. Nós a testamos com uma chamada somente leitura antes de salvar, guardamos criptografada e, a partir daí, mostramos só os últimos 4 caracteres. Uma chave secreta é recusada: uma chave restrita só pode fazer o que precisamos.

Sua conta Stripe

  • A conta é sua. Você tem o painel completo do Stripe. As cobranças são feitas na sua conta, então você é o vendedor.
  • Os repasses são do Stripe. Repasses, e Instant Payouts quando o Stripe torna sua conta elegível, ficam no seu painel do Stripe.
  • As taxas são do Stripe. As taxas do próprio Stripe ficam por sua conta e são descontadas no Stripe. Não ficamos com nenhuma parte da venda.
  • Apple Pay e Google Pay aparecem no pagamento hospedado do Stripe sem configuração.
  • Formas de pagamento locais aparecem quando combinam com a moeda do preço: Alipay e WeChat Pay, e em euros ou zlótis iDEAL, Bancontact, EPS, Przelewy24 e BLIK. Ative as que quiser no Stripe, em Configurações, depois Formas de pagamento. Uma desativada fica de fora. Todas pagam na hora, então o relógio desbloqueia na hora.
  • Defina um descritor de fatura claro, como o nome do seu app, para os compradores reconhecerem a cobrança na fatura.

O que escutamos

Conectado assim, você não adiciona webhook: o Stripe nos envia os eventos da sua conta.

Evento do StripeO que significaO que o relógio faz
checkout.session.completedPagoDesbloqueia em cerca de um segundo se a tela de compra estiver aberta; senão, na próxima consulta.
charge.refundedReembolsadoBloqueia na próxima verificação; na hora, se a tela de compra estiver aberta.
charge.dispute.createdUma contestação abertaBloqueia enquanto a contestação estiver aberta.
charge.dispute.closedA contestação terminouGanha: o relógio desbloqueia de novo, salvo reembolso. Perdida: continua bloqueado.
radar.early_fraud_warning.createdUm alerta de fraudeContinua desbloqueado. Avisamos você, para que possa reembolsar antes de uma taxa de contestação.
invoice.paidUma renovação pagaContinua desbloqueado.
invoice.payment_failedUma renovação recusadaBloqueia. O comprador é solicitado a atualizar o cartão.
invoice.payment_action_requiredO banco quer que o comprador confirmeMostra um QR code para a página de fatura do Stripe.
Assinatura canceled, unpaid ou pausedCancelada, ou as novas tentativas acabaramBloqueia.

Conferimos cada evento com o checkout que criamos: o relógio e o app nos metadados, o valor, a moeda, e se é teste ou produção.

Se o Stripe não conseguir nos alcançar

Pagamentos mostra Precisa de atenção, com a correção. Enquanto isso os pagamentos continuam passando, mas reembolsos e contestações não bloqueiam relógios até o Stripe nos alcançar de novo.

Reembolsos e contestações

  • Reembolse no seu painel do Stripe. Uma venda em Vendas leva direto para lá.
  • Reembolsar uma cobrança de assinatura não encerra a assinatura. Cancele-a no Stripe também.
  • Responda às contestações no Stripe. O relógio fica bloqueado enquanto houver uma contestação aberta.

O lado do relógio em cada caso está em Reembolsos, contestações e renovações.

Testar com o Stripe

  • Pague com 4242 4242 4242 4242, qualquer data futura e qualquer CVC.
  • Crie uma contestação de teste com 4000 0000 0000 0259.
  • Reembolse pelo painel de teste do Stripe.

Nunca faça reembolsos, recusas ou contestações na sua conta de produção para testar. Use o modo de teste.

Esc