Crie cobranças diretas

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.

Observação

Recomendamos usar cobranças diretas para contas conectadas que têm acesso ao Stripe Dashboard completo.

Web

iOS

Android

React Native

Incorpore um formulário de pagamento pré-integrado ao seu site usando o Stripe Checkout. Compare esta integração com as outras formas de integração da Stripe.

powdur.me

Esforço de integração

Low-code

Tipo de integração

Integrar um formulário de pagamento pré-configurado ao seu site

Personalização da IU

Personalização limitada

Primeiro, cadastre-se para obter uma conta Stripe.

Use nossas bibliotecas oficiais para acessar a API da Stripe no seu aplicativo:

Criar uma sessão do Checkout
Lado do servidor

Uma Sessão do Checkout controla o que o seu cliente vê no formulário de pagamento integrável, como itens de linha, o valor do pedido e a moeda. Crie uma sessão do Checkout em um endpoint no lado do servidor (por exemplo, /create-checkout-session). A resposta inclui um client_secret que você usará na próxima etapa para montar o Checkout.

line_items: este atributo representa os itens que seu cliente está comprando e é exibido no formulário de pagamento integrado.
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.
return_url - A Stripe redireciona o cliente para o URL de retorno após ele realizar uma tentativa de 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. Verifique se o URL de retorno corresponde a uma página no seu site que informe o status do pagamento. Também é possível anexar seus próprios parâmetros de consulta, que permanecem durante o processo de redirecionamento. Consulte personalizar comportamento de redirecionamento com um formulário integrado 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.

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, em exportações ou em outros relatórios, mas você pode recuperar essas informações usando a API da Stripe.

Montar Checkout
Lado do cliente

O Checkout está disponível como parte do Stripe.js. Inclua o script do Stripe.js na sua página, adicionando-o ao cabeçalho do arquivo HTML. Em seguida, crie um nó DOM vazio (contêiner) para usar na montagem.

index.html
<head>
  <script src="https://js.stripe.com/basil/stripe.js"></script>
</head>
<body>
  <div id="checkout">
    <!-- Checkout will insert the payment form here -->
  </div>
</body>

Inicialize o Stripe.js com sua chave de API publicável e o ID da conta conectada. Passe o client_secret da etapa anterior para options quando criar a instância do Checkout:

index.js
// Initialize Stripe.js
const stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx'
, {
   stripeAccount: {{CONNECTED_ACCOUNT_ID}}
,
});

initialize();

// Fetch Checkout Session and retrieve the client secret
async function initialize() {
  const fetchClientSecret = async () => {
    const response = await fetch("/create-checkout-session", {
      method: "POST",
    });
    const { clientSecret } = await response.json();
    return clientSecret;
  };

  // Initialize Checkout
  const checkout = await stripe.initEmbeddedCheckout({
    fetchClientSecret,
  });

  // Mount Checkout
  checkout.mount('#checkout');
}

O Checkout é renderizado em um iframe que envia dados de pagamento com segurança à Stripe por uma conexão HTTPS. Evite colocar o Checkout dentro de outro iframe porque algumas formas de pagamento exigem o redirecionamento para outra página para confirmação do pagamento.

Gerenciar eventos pós-pagamento
Lado do servidor

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:

Evento	Descrição	Próximas etapas
checkout.session.completed	O cliente autorizou o pagamento enviando o formulário do Checkout.	Aguarde a confirmação ou falha do pagamento.
checkout.session.async_payment_succeeded	O pagamento do cliente foi confirmado.	Execute o pedido de mercadorias ou serviços.
checkout.session.async_payment_failed	O pagamento foi recusado ou houve outro erro.	Entre em contato com o cliente por e-mail e solicite a realização de um novo pedido.

Todos esses eventos incluem o objeto Checkout Session. Após o pagamento, o status subjacente do PaymentIntent muda de processing para succeeded ou um status malsucedido.

Testar a integração

Número do cartão	Cenário	Como testar
	O pagamento com cartão é bem-sucedido e não precisa de autenticação.	Preencha o formulário do cartão de crédito usando o número do cartão de crédito com qualquer validade, CVC e código postal.
	O pagamento com cartão precisa de autenticação.	Preencha o formulário do cartão de crédito usando o número do cartão de crédito com qualquer validade, CVC e código postal.
	O cartão é recusado com um código de recusa como `insufficient_funds`.	Preencha o formulário do cartão de crédito usando o número do cartão de crédito com qualquer validade, CVC e código postal.
	O cartão UnionPay tem um comprimento variável de 13 a 19 dígitos.	Preencha o formulário do cartão de crédito usando o número do cartão de crédito com qualquer validade, CVC e código postal.

Consulte Testes para obter mais informações sobre como testar sua integração.

OpcionalHabilitar formas de pagamento adicionais

Navegue para Gerenciar formas de pagamento para suas contas conectadas no Dashboard para configurar quais formas de pagamento suas contas conectadas aceitam. As alterações nas configurações padrão se aplicam a todas as contas conectadas novas e existentes.

Consulte os seguintes recursos para obter informações sobre formas de pagamento:

Um guia de formas de pagamento para ajudar você a escolher as formas de pagamento corretas para sua plataforma.
Funções da conta para assegurar que as formas de pagamento escolhidas funcionem para suas contas conectadas.
Tabelas de suporte a formas de pagamento e produtos para assegurar que suas formas de pagamento escolhidas funcionem para seus produtos da Stripe e fluxos de pagamento.

Para cada forma de pagamento, você pode selecionar uma das seguintes opções no menu suspenso:

Ativadas por padrão	Suas contas conectadas aceitam esta forma de pagamento durante o checkout. Algumas formas de pagamento podem ser desativadas ou bloqueadas. Isso ocorre porque suas contas conectadas com acesso ao Stripe Dashboard precisam ativá-las em sua página de configurações.
Desativadas por padrão	Suas contas conectadas não aceitam esta forma de pagamento durante o checkout. Se você permitir que contas conectadas com acessem o Stripe Dashboard para gerenciar suas próprias formas de pagamento, elas podem ativar esse recurso.
Bloqueadas	Suas contas conectadas não aceitam esta forma de pagamento durante o checkout. Se você permitir que contas conectadas com acessem o Stripe Dashboard para gerenciar suas próprias formas de pagamento, elas não têm a opção para ativar esse recurso.

Opções suspensas para formas de pagamento, cada uma mostrando uma opção disponível (bloqueadas, ativadas por padrão, desativadas por padrão)

Opções de formas de pagamento

Se fizer uma alteração em uma forma de pagamento, você deve clicar em Revisar alterações na barra inferior da tela e em Salvar e aplicar para atualizar suas contas conectadas.

Diálogo exibido após clicar no botão Salvar, com uma lista das alterações feitas pelo usuário

Salvar diálogo

Permitir que contas conectadas gerenciem formas de pagamento

A Stripe recomenda permitir que as contas conectadas personalizem suas próprias formas de pagamento. Esta opção permite que cada conta conectada com acesso ao Stripe Dashboard para ver e atualizar sua página de formas de pagamento. Somente os proprietários das contas conectadas podem personalizar as formas de pagamento. O Stripe Dashboard exibe o conjunto de padrões de forma de pagamento que você aplicou a todas as contas conectadas novas e existentes. Suas contas conectadas podem sobrepor esses padrões, excluindo as formas de pagamento que você bloqueou.

Marque a caixa de seleção Personalização da conta para habilitar essa opção. Você deve clicar em Revisar alterações na barra inferior da tela e selecionar Salvar e aplicar para atualizar essa configuração.

Captura de tela da caixa de seleção a ser marcada ao permitir que proprietários conectados personalizem formas de pagamento

Caixa de seleção de personalização da conta

Funções das formas de pagamento

Para permitir que suas contas conectadas aceitem outras formas de pagamento, é preciso verificar se as contas conectadas têm funções ativas para cada forma de pagamento. A maioria das formas de pagamento tem os mesmos requisitos de verificação da função card_payments, com algumas restrições e exceções. A tabela de funções das formas de pagamento lista as formas de pagamento que exigem verificação adicional para cartões.

Navegue até as Configurações de pagamento de conta conectada no Dashboard para solicitar recursos em suas contas conectadas novas e existentes para cada combinação de forma de pagamento e país.

Coletar tarifas

Quando um pagamento é processado, sua plataforma pode receber uma parte da transação na forma de tarifas da plataforma. Você pode definir os preços da tarifa da plataforma de duas maneiras:

Use a ferramenta de preços da plataforma para definir e testar regras de preços. No momento, esse recurso no-code no Stripe Dashboard só está disponível para plataformas responsáveis pelo pagamento das tarifas da Stripe.
Defina internamente as regras de preços, especificando as tarifas da plataforma diretamente em um PaymentIntent. As tarifas definidas com esse método substituem a lógica de preços especificada na ferramenta de preços da plataforma.

Sua plataforma pode cobrar uma tarifa da plataforma com as seguintes limitações:

O valor de application_fee_amount deve ser positivo e inferior ao o valor da cobrança. A tarifa da plataforma recolhida é limitada ao valor capturado 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 por meio da Stripe.
A moeda de application_fee_amount depende de alguns fatores de várias moedas.

A transação de saldo da cobrança resultante inclui um detalhamento das tarifas da Stripe e da plataforma. Para melhorar a experiência com os relatórios, é criado um objeto Application Fee após a coleta da tarifa. Use a propriedade amount no objeto de tarifa do aplicativo para criar relatórios. Você pode acessar esses objetos com o endpoint Application Fees.

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

Por padrão, as tarifas da plataforma para cobranças diretas são criadas de forma assíncrona. Se você expandir o objeto application_fee em uma solicitação de criação de cobrança, a tarifa da plataforma será criada de forma síncrona como parte dessa solicitação. Somente expanda o objeto application_fee se for necessário, pois 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, escute o evento de 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).

Fluxo de fundos para uma cobrança com uma tarifa da plataforma

Se você processa pagamentos em várias moedas, veja como as moedas são gerenciadas no Connect.

Personalizar a marca

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 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.

Emitir reembolsos

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.

Componentes integrados do Connect

Componentes integrados do Connect suportam direct charges. Ao usar o componente integrado de pagamentos, você pode permitir que suas contas conectadas visualizem informações de pagamento, capturem cobranças e gerenciem contestações pelo seu site.

Os seguintes componentes exibem informações sobre Direct Charges:

Componente de pagamentos: Exibe todos os pagamentos e contestações de uma conta.
Detalhes dos pagamentos: Exibe informações de um pagamento específico.
Componente de lista de contestações: Exibe todas as contestações de uma conta.
Disputas para um componente de pagamento: Exibe as contestações para um único pagamento especificado. Você pode usá-lo para incluir a função de gerenciamento de contestação em uma página com sua IU de pagamentos.