O Stripe Connect recebe os pagamentos com cartão de um restaurante através da conta Stripe da própria plataforma, com o restaurante como conta conectada. Permite à plataforma ficar com uma taxa de cada pagamento — a taxa de aplicação — e repartir os reembolsos entre a plataforma e o restaurante.

Configuração#

  1. O restaurante liga a sua conta Stripe à plataforma. O ID da conta (acct_…) aparece no painel Stripe da plataforma em Connected accounts.
  2. Na Vista da Empresa, abra Finanças → Integração de Pagamento, clique em + no bloco Stripe e escolha Stripe Connect no topo do formulário.
  3. Preencha os campos abaixo — as chaves são as da própria plataforma — e clique em Guardar.
  4. Na Vista de Localização, abra Finanças → Métodos de Pagamento e escolha esta integração no método de pagamento Cartão.

Os primeiros campos são os mesmos do Stripe: Nome Identificador, Chave Pública, Chave Secreta, Segredo de assinatura do webhook, Liquidação Automática de Pagamentos, Apple Pay, Google Pay e ID do Comerciante iOS. O Stripe Connect acrescenta:

CampoO que é
Tipo de ContaPadrão (o restaurante tem a sua própria conta Stripe completa) ou Express (uma conta mais simples gerida pela plataforma).
Conta ConnectO ID da conta conectada do restaurante, acct_….
Tipo de CobrançaCobranças Diretas ou Cobranças de Destino — ver abaixo.
Taxa de Comissão do CartãoUma percentagem do valor dos artigos do pedido somada à taxa de aplicação, para repercutir os custos do cartão.
Taxa Fixa de CartãoUm valor fixo somado à taxa de aplicação em cada pagamento.
Subtrair Taxa de Entrega, Subtrair Gorjeta do Motorista, Subtrair Gorjeta, Subtrair Taxa de ServiçoQuando ativado, esse valor vai todo para a plataforma: é somado à taxa de aplicação em vez de ficar com o restaurante. Use-o quando é a plataforma que faz a entrega ou cobra a taxa de serviço.
Valor Fixo da Taxa de AplicaçãoUm valor fixo somado à taxa de aplicação em cada pagamento.
Taxa de Comissão PercentualA comissão da plataforma, em percentagem.
Regra de Taxa de ComissãoSobre o que é cobrada a comissão: Total (todo o valor que o cliente paga), ou qualquer combinação de Subtotal (os artigos), Taxa de Serviço, Taxa de Entrega, Gorjeta, Impostos e Gorjeta do Motorista.

Cobranças diretas e cobranças de destino#

Cobranças DiretasCobranças de Destino
Onde é feito o pagamentoNa conta conectada do restauranteNa conta da plataforma, sendo depois transferido para o restaurante
Nome no extrato do cartão do clienteO do restauranteO do restaurante
Quem paga a taxa de processamento de cartão do StripeO restauranteA plataforma
Como a plataforma é pagaA taxa de aplicação passa do restaurante para a plataformaA plataforma fica com a taxa de aplicação e transfere o resto
Quem vê o pagamento no StripeO restaurante, na totalidade; a plataforma vê a sua taxaA plataforma, na totalidade; o restaurante vê o valor transferido
Caso típicoContas Padrão: restaurantes com o seu próprio negócio no StripeContas Express: a plataforma gere os pagamentos pelo restaurante

A taxa de aplicação#

A taxa de aplicação é calculada para cada pedido no momento em que o cliente paga e é a soma de:

  • Taxa de Comissão Percentual × o que a Regra de Taxa de Comissão abrange;
  • Taxa de Comissão do Cartão × o valor dos artigos do pedido;
  • Taxa Fixa de Cartão e Valor Fixo da Taxa de Aplicação;
  • cada valor cujo interruptor Subtrair … esteja ativado (taxa de entrega, gorjeta do motorista, gorjeta, taxa de serviço).

O Subtotal corresponde aos artigos depois dos descontos quando o plano de utilização do estabelecimento cobra comissão após descontos (a definição habitual); caso contrário, antes deles.

Exemplo. Um pedido com uma lasanha ($32.00, com desconto para $22.40) e três tiramisùs ($42.00), com $5.72 de imposto sobre vendas e $11.10 de gorjeta, custa ao cliente $81.22. Com uma Taxa de Comissão Percentual de 8 sobre o Subtotal e nada mais definido, a taxa de aplicação é 8% × $64.40 = $5.15. O imposto e a gorjeta não pagam comissão.

Como um pedido com cartão fica pago#

Tal como no Stripe, o pedido fica em Cartão pendente até o Stripe confirmar o pagamento através do webhook da OrderTiger. No Stripe Connect, o webhook é criado na conta Stripe da plataforma com Events from: Connected accounts, para receber os pagamentos feitos nas contas dos restaurantes. O respetivo segredo de assinatura é guardado em Segredo de assinatura do webhook quando é criado.

Reembolsos#

Os reembolsos são feitos em Pedidos, com o botão de reembolso do pedido. Num pedido pago através do Stripe Connect, o formulário de reembolso pergunta O comerciante é responsável por este reembolso? — marcado por predefinição. A resposta decide quem paga o reembolso.

Responsabilidade do comerciante (marcado)Responsabilidade da plataforma (desmarcado)
ClienteRecebe de volta o valor reembolsadoRecebe de volta o valor reembolsado
RestaurantePaga o reembolso, incluindo as taxas de processamento de cartão do StripeFica com o valor original menos a taxa de aplicação original, como se o pedido não tivesse sido reembolsado. Com cobranças diretas continua a pagar a taxa de processamento de cartão do Stripe, como em qualquer venda
PlataformaDevolve a sua parte da taxa de aplicaçãoPaga todo o reembolso e fica com a sua taxa de aplicação
FaturasO reembolso é incluído e descontado nos ganhos do restauranteO reembolso não é incluído: a plataforma já o pagou

Num reembolso com responsabilidade do comerciante, a parte da taxa de aplicação que a plataforma devolve é a taxa de aplicação × o reembolso ÷ o total do pedido; um reembolso total devolve toda a taxa de aplicação. Um reembolso com responsabilidade da plataforma deixa a taxa de aplicação como estava.

Exemplo — o pedido de $81.22 acima, com a sua taxa de aplicação de $5.15. Para simplificar, a taxa de processamento de cartão do Stripe não é considerada.

Reembolsar a lasanha ($22.40)Reembolsar o pedido inteiro ($81.22)
Responsabilidade do comerciante: parte da taxa de aplicação devolvida$5.15 × 22.40 ÷ 81.22 = $1.42$5.15
Responsabilidade do comerciante: o restaurante fica com$76.07 − $22.40 + $1.42 = $55.09$0.00
Responsabilidade do comerciante: a plataforma fica com$5.15 − $1.42 = $3.73$0.00
Responsabilidade da plataforma: o restaurante fica com$81.22 − $5.15 = $76.07$81.22 − $5.15 = $76.07
Responsabilidade da plataforma: a plataforma fica com$5.15 − $22.40 = −$17.25$5.15 − $81.22 = −$76.07

Sem qualquer reembolso, o restaurante ficaria com $81.22 − $5.15 = $76.07 e a plataforma com $5.15.

Resolução de problemas#

ProblemaO que verificar
Um pedido pago fica em Cartão pendenteNo painel Stripe da plataforma, verifique se Developers → Webhooks tem o webhook da OrderTiger com Events from: Connected accounts e veja os envios recentes.
A taxa de aplicação não é a esperadaVerifique as caixas da Regra de Taxa de Comissão: Total cobra comissão sobre tudo o que o cliente paga, incluindo impostos e gorjeta.
Os pagamentos falham com um erro de contaA Conta Connect tem de ser uma conta conectada da conta da plataforma a que pertencem as chaves, no mesmo modo (teste ou produção).