Crie cobranças na conta da sua plataforma, colete tarifas e transfira imediatamente os fundos restantes para suas contas conectadas.
Crie cobranças de destino quando os clientes fizerem transações com sua plataforma para produtos ou serviços fornecidos por suas contas conectadas e você transferir fundos imediatamente para suas contas conectadas. Com este tipo de cobrança:
Você cria uma cobrança na conta da sua plataforma.
Você determina se alguns ou todos os fundos são transferidos para a conta conectada.
O custo das tarifas da Stripe e de reembolsos ou estornos é debitado da sua conta.
Esse tipo de cobrança é mais ideal para marketplaces como o Airbnb, um marketplace de aluguel residencial, ou a Lyft, um aplicativo de transporte por aplicativo.
As cobranças de destino só são aceitas se a plataforma e a conta conectada estiverem no mesmo país. Para compatibilidade entre regiões, você precisa especificar o comerciante da liquidação para a conta conectada usando o parâmetro on_behalf_of no Payment Intent ou em outros cenários válidos de transferências internacionais.
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, bem como formas de pagamento aceitáveis. Adicione um botão de checkout ao seu site para chamar um endpoint no lado do servidor e criar uma Sessão do Checkout.
payment_intent_data[transfer_data][destination] – Este parâmetro indica que esta é uma cobrança de destino. Uma cobrança de destino significa que a cobrança é processada na plataforma e, em seguida, os fundos são transferidos de forma imediata e automática para o saldo pendente da conta conectada.
line_items – Este parâmetro representa os itens que o cliente está comprando. Os itens são exibidos no formulário de pagamento integrado.
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.
payment_intent_data[application_fee_amount] - este parâmetro especifica o valor planejado pela sua plataforma para retirar da transação. O valor total da cobrança é imediatamente transferido da plataforma para a conta conectada que é especificada por transfer_data[destination] após a captura da cobrança. O application_fee_amount é transferido de volta para a plataforma, e a tarifa da Stripe é deduzida do valor da plataforma.
Ao processar cobranças de destino, o Checkout usa as configurações de marca da conta da sua plataforma. Consulte personalizar marca para obter mais informações.
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.
Ao criar cobranças com application_fee_amount, o valor total da cobrança é imediatamente transferido da plataforma para a conta transfer_data[destination] depois que a cobrança é capturada. O valor application_fee_amount (limitado ao valor total da cobrança) é transferido de volta à plataforma em seguida.
Após a coleta da tarifa da plataforma, um objeto Application Fee é criado. Há uma lista de tarifas da plataforma no Dashboard, com as tarifas da plataforma ou no Sigma. Você também pode usar a propriedade amount no objeto Application Fee para obter relatórios detalhados de tarifas.
Quando usar um application_fee_amount, lembre-se:
O application_fee_amount é limitado ao valor total da transação.
O application_fee_amount é sempre computado na mesma moeda da transação.
Sua plataforma paga a tarifa da Stripe após a transferência do application_fee_amount para sua conta.
Nenhuma tarifa da Stripe adicional é aplicada ao valor.
Sua plataforma pode usar relatórios integrados de tarifas da plataforma para reconciliar as tarifas cobradas.
Nos dashboards hospedados pela Stripe ou em componentes como o componente de detalhes do pagamento, sua conta conectada pode visualizar o valor total e o valor da tarifa da plataforma.
Fluxo de fundos
Com o código acima, o valor total da cobrança (US$ 10,00) é adicionado ao saldo pendente da conta conectada. O valor application_fee_amount (US$ 1,23) é subtraído do valor da cobrança e transferido para sua plataforma. As tarifas da Stripe (US$ 0,59) são subtraídas do saldo da conta da plataforma. O valor da tarifa da plataforma, deduzido das tarifas da Stripe (US$ 1,23 - US$ 0,59 = US$ 0,64), permanece no saldo da conta da plataforma.
O application_fee_amount é disponibilizado no cronograma de transferências normal da conta da plataforma, assim como os fundos das cobranças normais da Stripe.
Personalizar a marca
Sua plataforma usa as configurações de marca no Dashboard para personalizar a marca na página de pagamentos. Para cobranças de destino, o Checkout usa as configurações de marca da conta da plataforma. Para cobranças de destino com on_behalf_of, o Checkout usa as configurações de marca da conta conectada.
As plataformas podem definir as configurações de marca das contas conectadas usando a API Update Account:
icon - Exibido próximo ao nome da empresa, no cabeçalho da página de Checkout.
logo - É usado 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.
O comerciante da liquidação depende das funções da conta e da forma de criação da cobrança. Ele determina quais dados são usados para fazer a cobrança. Isso inclui a descrição no extrato (da plataforma ou da conta conectada) exibida sobre essa cobrança no extrato bancário ou de cartão de crédito do cliente.
A especificação do comerciante da liquidação permite que você defina mais explicitamente para quem as cobranças são criadas. Por exemplo, algumas plataformas preferem ser o comerciante da liquidação porque o cliente final interage diretamente com a plataforma (como plataformas sob demanda). No entanto, algumas plataformas têm contas conectadas que interagem diretamente com os clientes finais (como lojas de uma plataforma de e-commerce). Nesses cenários, pode fazer mais sentido que a conta conectada seja o comerciante da liquidação.
Você pode definir o parâmetro on_behalf_of para o ID de uma conta conectada para tornar essa conta o comerciante de liquidação do pagamento. Quando usar on_behalf_of:
As cobranças são liquidadas no país da conta conectada e na moeda de liquidação.
É usada a estrutura de tarifas do país da conta conectada.
A descrição no extrato da conta conectada é exibida no extrato do cartão de crédito do cliente.
Se a conta conectada estiver em um país diferente do da plataforma, o endereço e o número de telefone da conta conectada serão exibidos no extrato do cartão de crédito do cliente.
O número de dias que um saldo pendente é retido antes de receber o repasse depende da configuração delay_days na conta conectada.
Se on_behalf_of for omitido, a plataforma será a empresa registrada para o pagamento.
As cobranças criadas na conta da plataforma podem ser reembolsadas usando a chave secreta da conta da plataforma. No reembolso de uma cobrança que tem transfer_data[destination], por padrão, a conta de destino mantém os fundos que foram transferidos para ela e o saldo negativo do reembolso é coberto pela conta da plataforma. Para recuperar os fundos da conta conectada a fim de cobrir o reembolso, defina o parâmetro reverse_transfer como true na criação do reembolso:
Por padrão, o valor total da cobrança é reembolsado, mas você pode criar um reembolso parcial definindo amount como um inteiro positivo.
Se o valor total da cobrança é reembolsado, toda a transferência é anulada. Caso contrário, um valor proporcional da transferência é anulado.
Reembolsar tarifas da plataforma
Quando você reembolsa uma cobrança com uma tarifa da plataforma, por padrão, a conta da plataforma mantém os fundos da tarifa da plataforma. Para devolver esses fundos para a conta conectada, defina o parâmetro refund_application_fee como true na criação do reembolso:
Se você reembolsar a tarifa da plataforma em uma cobrança de destino, precisa anular a transferência. Se o valor total da cobrança é reembolsado, toda a tarifa da plataforma é anulada. Caso contrário, um valor proporcional da tarifa da plataforma é reembolsado.
Você também pode informar um valor false para refund_application_fee e reembolsar a tarifa da plataforma separadamente usando a API.
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.