Criar assinaturas com o Stripe Billing

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.payment_intent para incluir o Payment Element, que é necessário para confirmar o pagamento. Saiba mais sobre 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_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price]"=
{{PRICE_ID}} \
  -d "expand[0]"="latest_invoice.payment_intent"

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.payment_intent para incluir o Payment Element, que é necessário para confirmar o pagamento. Saiba mais sobre 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_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price]"=
{{PRICE_ID}} \
  -d "expand[0]"="latest_invoice.payment_intent" \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

Etapas adicionais antes de você criar uma assinatura

To create a destination charge, define both the customer and the price on the platform account. You must have created a connected account on the platform. The customer must exist within the platform account. When using destination charges, the platform is the merchant of record.

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.

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.

Stripe creates event notifications when changes happen in your account, like when a recurring payment succeeds or when a payout fails. To receive these notifications and use them to automate your integration, set up a webhook endpoint. For example, you could provision access to your service when you receive the invoice.paid event.

Event notifications for Connect and subscriptions integrations

Here are the event notifications that Connect integrations typically use.

Here are the event notifications that subscriptions integrations typically use.

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.