Stripe recebe os pagamentos com cartão dos pedidos online diretamente numa conta Stripe: a conta a que pertencem as chaves da integração, normalmente a do próprio restaurante. O Stripe transfere os fundos dessa conta para o respetivo banco. A OrderTiger não cobra nenhuma taxa dentro do Stripe; quaisquer valores da OrderTiger são cobrados à parte nas faturas do restaurante.
Para ficar com uma parte de cada pagamento dentro do Stripe, ou para receber pagamentos em nome dos restaurantes, use antes o Stripe Connect.
Configuração#
- Na Vista da Empresa, abra Finanças → Integração de Pagamento e clique em + no bloco Stripe.
- Deixe Stripe selecionado no topo do formulário (e não Stripe Connect).
- Preencha os campos abaixo e clique em Guardar.
- Na Vista de Localização, abra Finanças → Métodos de Pagamento, adicione ou edite o método de pagamento Cartão e escolha esta integração como processador de pagamento.
| Campo | O que é |
|---|---|
| Nome Identificador | O nome que dá à integração, apresentado nas listas e quando a escolhe num método de pagamento. |
| Chave Pública | A chave publicável do Stripe (pk_live_… ou pk_test_…), em Developers → API keys no Stripe. |
| Chave Secreta | A chave secreta do Stripe (sk_live_… ou sk_test_…) da mesma conta. Fica oculta por predefinição; clique no ícone de olho para a ver. |
| Segredo de assinatura do webhook | Opcional. Deixe-o vazio: ao guardar, a OrderTiger cria o seu webhook nesta conta Stripe e preenche este campo por si. |
| Liquidação Automática de Pagamentos | Ativada: o cartão é cobrado logo que o cliente paga. Desativada: o valor fica apenas cativo no cartão e é cobrado quando o pedido é aceite. Nos estabelecimentos que confirmam os pedidos automaticamente, a cobrança é sempre imediata. |
| Apple Pay / Google Pay | Disponibiliza estas carteiras no checkout. O Apple Pay exige também que o domínio esteja verificado no Stripe. |
| ID do Comerciante iOS | O ID de comerciante Apple Pay usado pela aplicação de pedidos para iOS. Só é apresentado aos superadministradores. |
Como um pedido com cartão fica pago#
Quando o cliente paga, o pedido fica em Cartão pendente até o Stripe confirmar o pagamento. O Stripe confirma-o chamando o webhook da OrderTiger; o pedido passa então a pago e aparece em Pedidos ao vivo.
- O webhook é criado automaticamente na conta Stripe quando a integração é guardada e fica à escuta de
charge.succeeded. Aparece no Stripe em Developers → Webhooks. - O respetivo segredo de assinatura é guardado em Segredo de assinatura do webhook. Com um segredo guardado, a OrderTiger só aceita confirmações de pagamento que tragam a assinatura do Stripe. Sem segredo, a confirmação é aceite sem essa verificação.
- Se o webhook já existia quando guardou, é reutilizado e o campo fica vazio: o Stripe só revela o segredo de um webhook no momento em que é criado. Copie-o do webhook no Stripe (Reveal) e cole-o no campo, ou elimine o webhook no Stripe e guarde a integração novamente.
Reembolsos#
Os reembolsos são feitos em Pedidos, com o botão de reembolso do pedido. O reembolso sai da mesma conta Stripe que recebeu o pagamento e regressa ao cartão do cliente.
- Não há taxa a repartir: o reembolso sai todo dessa conta.
- O Stripe não devolve a sua taxa de processamento de cartão num reembolso.
- Nos pedidos de uma empresa do tipo portal, o formulário de reembolso pergunta O comerciante é responsável por este reembolso?. Com Stripe simples, o dinheiro sai sempre desta conta Stripe; a resposta só decide como o reembolso aparece nas faturas: um reembolso da responsabilidade do comerciante é descontado nos ganhos do restaurante, um da responsabilidade da plataforma não.
- Um reembolso pode ser parcial; os valores já reembolsados aparecem listados no pedido.
Resolução de problemas#
| Problema | O que verificar |
|---|---|
| Um pedido pago fica em Cartão pendente e nunca chega a Pedidos ao vivo | A confirmação do Stripe não chegou. No Stripe, verifique se Developers → Webhooks tem o webhook da OrderTiger e veja os envios recentes. Se não existir, guarde a integração novamente para o criar. |
| Segredo de assinatura do webhook continua vazio depois de guardar | O webhook já existia. Cole o respetivo segredo a partir do Stripe, ou elimine o webhook no Stripe e guarde novamente. |
| Os pagamentos falham com um erro de autenticação | A Chave Secreta e a Chave Pública têm de ser da mesma conta Stripe e do mesmo modo (ambas de teste ou ambas de produção). |