Crie cobranças diretamente na conta conectada e receba tarifas.
Crie cobranças diretas quando os clientes fazem transações diretamente com uma conta conectada e muitas vezes nem percebem a existência da sua plataforma. Com cobranças diretas:
O pagamento aparece como cobrança na conta conectada, e não na conta da sua plataforma.
O saldo da conta conectada aumenta a cada cobrança.
O saldo da sua conta aumenta com as tarifas da plataforma de cada cobrança.
Esse tipo de cobrança é mais adequado para plataformas que fornecem software como serviço. A Shopify, por exemplo, oferece ferramentas para a criação de lojas online e a Worksify permite que professores vendam cursos online.
Uma Sessão do Checkout controla o que o seu cliente vê no formulário de pagamento, como itens de linha, o valor do pedido e a moeda. Adicione um botão de checkout ao seu site para chamar um endpoint no lado do servidor e criar uma Sessão do Checkout.
line_items - Este atributo representa os itens que o cliente está comprando e é exibido na página de checkout hospedada pela Stripe.
payment_intent_data[application_fee_amount]: este atributo especifica o valor que sua plataforma deduz da transação como tarifa da plataforma. Depois que o pagamento é processado na conta conectada, o application_fee_amount é transferido para a plataforma. Consulte coletar tarifas para obter mais informações.
success_url - A Stripe redireciona o cliente para o URL de êxito após a conclusão de um pagamento e substitui a string {CHECKOUT_SESSION_ID} pelo ID da sessão do Checkout. Use para acessar a sessão do Checkout e inspecionar o status para decidir o que mostrar ao cliente. Também é possível anexar seus próprios parâmetros de consulta, que permanecem durante o processo de redirecionamento. Consulte personalizar o comportamento de redirecionamento com uma página hospedada pela Stripe para saber mais.
Stripe-Account - Este cabeçalho indica uma cobrança direta para sua conta conectada. A marca da conta conectada é usada no Checkout, o que permite que os clientes sintam que estão interagindo diretamente com a conta conectada em vez de com sua plataforma. Consulte
As cobranças que você cria diretamente na conta conectada são relatadas apenas nessa conta. Essas cobranças não aparecem no Dashboard da plataforma ou em exportações. Cobranças diretas estão incluídas em relatórios e no Sigma para contas conectadas controladas por sua plataforma. Você pode recuperar essas informações usando a API da Stripe.
A Stripe envia um evento checkout.session.completed quando o pagamento é concluído. Use um webhook para receber esses eventos e executar ações, como enviar um e-mail de confirmação de pedido ao cliente, registrar a venda em um banco de dados ou iniciar um fluxo de entrega.
Escute esses eventos em vez de aguardar um retorno de chamada do cliente. No cliente, o consumidor poderia fechar a janela do navegador ou sair do aplicativo antes da execução do retorno de chamada. Algumas formas de pagamento também demoram de 2 a 14 dias para a confirmação do pagamento. Configurar sua integração para escutar eventos assíncronos é o que permite a você aceitar diferentes tipos de formas de pagamento com uma única integração.
A Stripe recomenda gerenciar todos os eventos a seguir ao receber pagamentos com o Checkout:
Entre em contato com o cliente por e-mail e solicite a realização de um novo pedido.
Esses eventos incluem o objeto Checkout Session. Após o êxito do pagamento, o status subjacente do PaymentIntentstatus muda de processing para succeeded ou um status malsucedido.
Sua plataforma pode cobrar uma tarifa da plataforma com as seguintes limitações:
O valor de application_fee_amount deve ser positivo e menor que o valor da cobrança. O valor máximo de tarifa da plataforma que pode ser coletado é o valor da cobrança.
Não há tarifas adicionais da Stripe sobre a própria tarifa da plataforma.
De acordo com os requisitos regulatórios e de conformidade do Brasil, as plataformas de fora do Brasil com contas conectadas brasileiras não podem coletar tarifas da plataforma pela Stripe.
A moeda de application_fee_amount depende de alguns fatores de várias moedas.
A transação de saldo resultante da cobrança inclui um detalhamento das tarifas da Stripe e da plataforma. Para oferecer uma melhor experiência com os relatórios, uma tarifa da plataforma é criada após a coleta da tarifa. Use a propriedade amount no objeto de tarifa da plataforma para criar relatórios. Assim, você poderá acessar esses objetos com o endpoint de tarifas da plataforma.
As tarifas da plataforma recebidas são adicionadas ao saldo disponível da sua conta no mesmo cronograma que os fundos das cobranças regulares da Stripe. Você pode consultá-las na seção Tarifas cobradas do Dashboard.
Cuidado
As tarifas da plataforma para cobranças diretas são criadas de forma assíncrona por padrão. Se você expandir o objeto application_fee em uma solicitação de criação de cobrança, a tarifa da plataforma é criada de forma síncrona como parte dessa solicitação. Somente expanda o objeto application_fee se for absolutamente necessário, porque isso aumenta a latência da solicitação.
Para acessar os objetos de tarifa da plataforma para tarifas da plataforma criadas de forma assíncrona, ouça o evento do webhook application_fee.created.
Fluxo de fundos com tarifas
Quando você especifica uma tarifa de plataforma sobre uma cobrança, o valor da tarifa é transferido para a conta da sua plataforma na Stripe. Ao processar uma cobrança diretamente na conta conectada, o valor da cobrança (menos as tarifas da Stripe e da plataforma) é depositado na conta conectada.
Por exemplo, se você fizer uma cobrança de US$ 10 com uma tarifa da plataforma de US$ 1,23 (como no exemplo anterior), US$ 1,23 será transferido para a conta da sua plataforma. US$ 8,18 (US$ 10 - US$ 0,59 - US$ 1,23) são depositados na conta conectada (considerando as tarifas padrão da Stripe dos EUA).
Sua plataforma e suas contas conectadas podem usar as Configurações de marca no Dashboard para personalizar as marcas na página de pagamentos. Para cobranças diretas, o Checkout usa as configurações de marca da conta conectada.
Você também pode usar a API para atualizar as configurações de marca:
icon - Exibido próximo ao nome da empresa, no cabeçalho da página de Checkout.
logo - É exibido no lugar do ícone e do nome da empresa, no cabeçalho da página de Checkout.
primary_color - Cor de fundo da página de Checkout.
secondary_color - Cor dos botões da página de Checkout.
Além de criar cobranças em contas conectadas, as plataformas também podem criar reembolsos de cobranças em contas conectadas. Crie um reembolso usando a chave secreta da sua plataforma, estando autenticado com as credenciais da conta conectada.
As tarifas da plataforma não são reembolsadas automaticamente quando um reembolso é emitido. Sua plataforma deve reembolsar explicitamente a tarifa da plataforma, caso contrário a conta conectada (a conta na qual a cobrança foi criada) perde esse valor. Você pode reembolsar uma tarifa de plataforma passando um valor refund_application_fee de verdadeiro na solicitação de reembolso:
Por padrão, toda a cobrança é reembolsada, mas você pode criar um reembolso parcial definindo um amount como um número inteiro positivo. Se o reembolso for ao valor total da cobrança, toda a tarifa da plataforma será reembolsada. Caso contrário, um valor proporcional da tarifa da plataforma será reembolsado. Como opção, você pode informar um valor refund_application_fee de falso e reembolsar a tarifa da plataforma separadamente.
Welcome to the Stripe Shell!
Stripe Shell is a browser-based shell with the Stripe CLI pre-installed. Log in to your
Stripe account and press Control + Backtick (`) on your keyboard to start managing your Stripe
resources in test mode.
- View supported Stripe commands:
- Find webhook events:
- Listen for webhook events:
- Call Stripe APIs: stripe [api resource] [operation] (e.g., )
O Stripe Shell oferece uma melhor experiência em desktops.