Criar assinaturas com o Stripe Billing

Empresas de software como serviço (SaaS) e de marketplace usam o Stripe Connect para direcionar pagamentos entre si, clientes e contas conectadas. Você pode usar o Connect para direcionar pagamentos ou repasses e usar o Stripe Billing para apoiar seu modelo de receitas recorrentes.

Casos de uso

Você pode criar assinaturas para conectar contas, o que apoia várias abordagens para coletar pagamentos. Também é possível criar assinaturas para seus clientes de contas conectadas usando cobranças diretas ou cobranças de destino, para que seus clientes finais façam transações diretamente com a sua plataforma, e para cobrar uma tarifa das suas contas conectadas por usar sua plataforma.

Os seguintes casos de uso descrevem como usar o Stripe Billing para criar assinaturas de clientes finais para contas conectadas, para faturar clientes finais da plataforma e para faturar contas conectadas.

Restrições

O uso de assinaturas com o Connect tem as seguintes restrições:

• Sua plataforma não pode atualizar ou cancelar uma assinatura que não criou.
• Sua plataforma não pode adicionar um application_fee_amount a uma fatura que não criou, nem a uma fatura que contenha itens de fatura que a plataforma não criou.
• Only connected accounts with access to the full Stripe Dashboard can manage their customers’ subscriptions. For other connected accounts, the platform must manage their customers’ subscriptions.
• Assinaturas não são automaticamente canceladas quando você se desconecta da plataforma. É preciso cancelar a assinatura após a desconexão. Você pode usar webhooks para monitorar a atividade das contas conectadas.

Criar assinaturas do cliente final para a conta conectada

Se estiver construindo uma plataforma, você pode criar assinaturas para os clientes da sua conta conectada, opcionalmente cobrando uma tarifa por pagamento para a sua plataforma.

Este exemplo cria uma plataforma de publicação online que permite aos clientes assinar seus autores favoritos e pagar uma tarifa mensal a eles para receber publicações de blog premium de cada autor.

Antes de começar

Antes de poder criar assinaturas para seus clientes ou contas conectadas, você deve:

1. Criar uma conta conectada para cada pessoa que receber dinheiro na sua plataforma. No nosso exemplo de publicação online, uma conta conectada representa um autor.
2. Criar um modelo de preços. Para esse exemplo, criamos um modelo de preço de taxa fixa para cobrar uma tarifa dos clientes de forma recorrente, mas preços por usuário e por uso também são aceitos.
3. Crie um cliente com a forma de pagamento desejada para cada pessoa que assinar uma conta conectada. Em nosso exemplo de publicação online, você cria um cliente para cada máquina que assina um autor.

Decidir entre Direct Charges e Destination Charges

Você pode usar cobranças diretas ou cobranças de destino para dividir o pagamento de um cliente entre a conta conectada e sua plataforma.

Com cobranças diretas, os clientes não saberão da existência da sua plataforma porque o nome do autor, e não o nome da sua plataforma, é exibido na descrição do extrato. No nosso exemplo de publicação online, os leitores interagem com os autores diretamente.

As cobranças diretas são recomendadas para contas conectadas com acesso ao Stripe Dashboard completo, o que inclui contas Standard.

Se quiser que sua plataforma seja responsável pelas tarifas da Stripe, reembolsos e estornos, use cobranças de destino. No nosso exemplo de publicação, os clientes assinam sua plataforma de publicação, não diretamente com autores específicos.

As cobranças de destino são recomendadas para contas conectadas com acesso ao Dashboard Express ou contas conectadas sem acesso a um Dashboard hospedado pela Stripe, o que inclui contas Express e Custom.

Para obter mais informações sobre os diferentes tipos de cobranças do Connect, consulte Tipos de cobrança.

Usar Direct Charges para criar uma assinatura

Para criar uma assinatura com Charges associadas à conta conectada, crie assinatura estando autenticado como a conta conectada. Certifique-se de definir o cliente com uma forma de pagamento padrão e o Preço na conta conectada. Para usar um cliente sem uma forma de pagamento padrão, defina payment_behavior: "default_incomplete". Saiba mais sobre o comportamento de pagamento.

Expanda latest_invoice.confirmation_secret para incluir o Payment Element, do qual você precisa para confirmar o pagamento. Saiba mais sobre os Payment Elements.

Para um exemplo completo de como implementar uma inscrição de assinatura e um fluxo de pagamento no seu aplicativo, consulte o guia Integração de assinaturas.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price]"=
{{PRICE_ID}} \
  -d "expand[0]"="latest_invoice.confirmation_secret"

Usar cobranças de destino para criar uma assinatura

Para criar uma assinatura com Charges associadas à plataforma e criar automaticamente transferências para uma conta conectada, fazer uma chamada criar assinatura enquanto fornece o ID da conta conectada como o valor de transfer_data[destination].

Expanda latest_invoice.confirmation_secret para incluir o Payment Element, do qual você precisa para confirmar o pagamento. Saiba mais sobre os Payment Elements.

Opcionalmente, você pode especificar uma application_fee_percent. Saiba mais sobre coletar tarifas.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price]"=
{{PRICE_ID}} \
  -d "expand[0]"="latest_invoice.confirmation_secret" \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Etapas adicionais antes de você criar uma assinatura

Para criar uma cobrança de destino, defina o cliente e o preço na conta da plataforma. Você deve ter criado uma conta conectada na plataforma. O cliente deve existir dentro da conta da plataforma. Quando você usa cobranças de destino, a plataforma é o comerciante responsável.

Criar assinaturas para cobrar plataforma e clientes

Você pode usar o Stripe Billing para criar assinaturas para os seus clientes finais para fazer transações diretamente com sua plataforma sem envolver suas contas conectadas.

Este exemplo cria um marketplace que permite aos clientes fazer pedidos de entregas de restaurantes sob demanda. Esse marketplace oferece aos clientes uma assinatura mensal premium que os isenta de taxas de entrega. Os clientes que assinam a oferta premium pagam o marketplace diretamente e não assinam nenhum serviço de entrega ou restaurante específico.

Antes de começar

Antes de você criar assinaturas para os clientes, é preciso:

1. Criar um modelo de preços. Para esse exemplo, criamos um modelo de preço de taxa fixa para cobrar uma tarifa dos clientes de forma recorrente, mas preços por usuário e por uso também são aceitos.
2. Criar um registro de cliente para cada cliente que desejar faturar.

Você também pode criar uma conta conectada para cada usuário que receber dinheiro do seu marketplace. No nosso exemplo de entrega sob demanda de restaurantes, uma conta conectada é um restaurante ou um serviço de entrega. No entanto, essa etapa não é exigida para os clientes assinarem seu marketplace diretamente.

Criar uma assinatura

Para criar uma assinatura na qual sua plataforma recebe os fundos, sem qualquer dinheiro indo para as contas conectadas, siga o Guia de assinaturas para criar uma assinatura com o Stripe Billing.

Criar cobranças e transferências separadas

Se quiser fazer posteriormente uma transferência manual de parte dos fundos que sua plataforma recebe para suas contas conectadas, use cobranças e transferências separadas para repassar fundos para uma ou mais contas conectadas. No nosso exemplo de entrega sob demanda de restaurantes, você pode usar cobranças e transferências separadas para repassar uma tarifa de afiliado para um motorista de entrega ou restaurante que encaminha um cliente para assinar o serviço de entrega premium.

Criar assinaturas para cobrar contas conectadas

Você pode usar o Stripe Billing para criar assinaturas para cobrar uma tarifa de suas contas conectadas por usar sua plataforma.

Este exemplo cria uma plataforma de software de gerenciamento de academias que permite às academias pagar uma tarifa mensal para usar o software para gerenciar o cronograma e a marcação de aulas. As academias pagam a tarifa de assinatura, não os usuários da academia.

O software de gerenciamento de academias também facilita pagamentos avulsos entre o usuário e a academia por cada aula em que o usuário estiver inscrito. A assinatura mensal é entre a conta conectada e a plataforma, não envolvendo o usuário da academia na transação.

No diagrama acima, a academia é a conta conectada e o usuário da academia é o consumidor final.

Antes de começar

Antes de criar assinaturas para seus clientes ou contas conectadas, você deve:

1. Crie uma conta conectada para cada usuário que receber dinheiro na sua plataforma. Neste exemplo, a conta conectada é a academia.
2. Criar um modelo de preços. Para esse exemplo, criamos um modelo de preço de taxa fixa para cobrar uma tarifa dos clientes de forma recorrente, mas preços por usuário e por uso também são aceitos.
3. Crie um cliente na plataforma com a forma de pagamento pretendida para cada conta conectada que você quiser faturar. No exemplo de software de gerenciamento de academias, você cria um cliente para cada academia:

Criar um objeto Customer para representar a conta conectada

Se as suas contas conectadas usarem a Stripe para processar pagamentos para seus clientes finais, elas podem já ter criado um objeto Customer para cada cliente final.

Para criar uma assinatura corretamente para que a conta conectada pague uma tarifa recorrente à plataforma, é preciso criar um objeto Customer separado para representar a conta conectada.

No exemplo da academia, as academias usam a Stripe para processar pagamentos avulsos de seus usuários. Eles já criaram um objeto Customer para cada usuário, mas você precisa criar um objeto Customer diferente para representar a própria academia. Crie somente um Customer para representar cada entidade comercial e não crie um Customer para representar cada proprietário, gerente ou operador do negócio.

Criar uma assinatura para a conta conectada

Para criar uma assinatura na qual sua plataforma recebe os fundos das suas contas conectadas, siga o Guia de assinatura para criar uma assinatura com o Stripe Billing. O objeto Customer envolvido na transação representa a conta conectada. No nosso exemplo da academia, o CUSTOMER_ID representa a academia, não o usuário da academia.

Habilite sua integração para receber notificações de evento

A Stripe cria notificações de evento quando alterações ocorrem em sua conta, como quando um pagamento recorrente é bem-sucedido ou quando um repasse falha. Para receber essas notificações e usá-las para automatizar sua integração, configure um endpoint de webhook. Por exemplo, você pode provisionar acesso ao seu serviço ao receber o evento invoice.paid.

Notificações de eventos para integrações do Connect e de assinaturas

Estas são as notificações de evento usadas pelas integrações do Connect.

Estas são as notificações de evento usadas pelas integrações de assinaturas.

Teste a integração

Após você criar sua assinatura, teste cuidadosamente sua integração antes de expô-la aos clientes ou usá-la para qualquer atividade real. Saiba mais sobre testes do Stripe Billing.

Opções adicionais

Depois de criar sua assinatura, você pode especificar um application_fee_percent, configurar o portal do cliente, cobrar seu cliente usando o parâmetro on_behalf_of e monitorar assinaturas com webhooks, além de outras opções.