Configurar uma assinatura com o PayPal
Saiba como criar e cobrar uma assinatura com o PayPal.
Use este guia para configurar uma assinatura usando o PayPal e o Checkout.
Uma sessão do Checkout representa os detalhes da intenção do cliente de fazer a compra. Crie uma sessão do Checkout quando um cliente quiser iniciar uma assinatura. Após redirecionar um cliente para uma sessão do Checkout, a Stripe apresenta um formulário de pagamento onde ele pode concluir a compra. Após a conclusão de uma compra, a Stripe redireciona o usuário de volta ao seu site.
Habilitar pagamentos recorrentes do PayPal
A Stripe ativa automaticamente os pagamentos recorrentes para a maioria dos usuários quando eles ativam pagamentos do PayPal no Stripe Dashboard. No entanto, devido às políticas do PayPal e às restrições regionais, talvez seja necessário que habilitar manualmente os pagamentos recorrentes do PayPal no Dashboard.
Primeiro, você precisa de uma conta Stripe. Cadastre-se agora.
Use nossas bibliotecas oficiais para acessar a API da Stripe no seu aplicativo:
Cuidado
A API Prices unifica a forma como as compras únicas e as assinaturas são modeladas na Stripe. As integrações existentes que não usam a API Prices ainda são aceitas. No entanto, alguns recursos do Checkout aceitam apenas o Prices. Consulte o guia de migração para atualizar para a API Prices.
Antes de usar o Checkout, você precisa criar um produto e um preço. Mercadorias físicas ou níveis de serviço diferentes devem ser representados por produtos. Cada produto pode ter um ou mais preços.
Por exemplo, você pode criar um produto de software que tenha quatro preços: 10 USD/mês, 100 USD/ano, 9 EUR/mês e 90 EUR/ano. Isso permite alterar e adicionar preços sem precisar alterar os detalhes dos produtos correspondentes. Você pode criar um produto e preço usando a API ou usando o Stripe Dashboard.
Quando o preço é determinado no checkout (por exemplo, o cliente define o valor da doação) ou você prefere não criar preços antecipadamente, é possível criar preços em linha na criação da sessão do Checkout.
Adicione um botão de checkout ao seu site para chamar um endpoint do lado do servidor e criar uma Sessão do Checkout.
Crie uma sessão do Checkout com o ID de um preço existente. Certifique-se de que o modo esteja definido como subscription e você passe pelo menos um preço recorrente. Você pode adicionar preços avulsos além de preços recorrentes. Depois de criar a sessão do Checkout, redirecione o cliente para o URL retornado na resposta.
Quando o cliente finaliza um pagamento, é redirecionado para o success_, uma página no seu site que informa ao cliente que o pagamento foi bem-sucedido. Disponibilize o ID da sessão na página de sucesso incluindo a variável de modelo {CHECKOUT_ no success_ como no exemplo acima.
Quando o cliente clica no seu logotipo em uma sessão do Checkout sem concluir o pagamento, o Checkout redireciona o cliente de volta ao site, navegando para o cancel_. Normalmente, essa é a página no seu site que o cliente visualizou antes de ser redirecionado para o Checkout.
As Sessões do Checkout expiram 24 horas após a criação por padrão.
Cuidado
Não dependa apenas do redirecionamento ao success_ para detectar a iniciação de um pagamento, pois:
- Usuários mal-intencionados podem acessar diretamente o
success_sem pagar e acessar seus produtos ou serviços.url - Os clientes podem não acessar o
success_após o pagamento. Eles podem fechar a guia do navegador antes do redirecionamento.url
Observação
Quando um comprador confirma uma assinatura na Stripe com PayPal, recebe um recibo da Stripe e outro do PayPal.
Quando o cliente conclui um pagamento, é redirecionado para o URL especificado como success_. Normalmente, é uma página no site que informa ao cliente que o pagamento foi bem-sucedido.
Use o Dashboard, um webhook personalizado ou um plugin de terceiros para processar eventos pós-pagamento, 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.
Use plugins como o Zapier para automatizar a atualização dos seus sistemas de execução de compras com dados dos pagamentos da Stripe.
Alguns exemplos de automação aceitas por plugins incluem:
- Atualizar planilhas usadas para acompanhamento de pedidos em resposta a pagamentos efetivados
- Atualizar sistemas de gerenciamento de inventário em resposta a pagamentos efetivados
- Acionar notificações a equipes internas de atendimento ao cliente usando e-mail ou aplicativos de chat
Teste a integração do PayPal com as chaves de API de teste visualizando a página de redirecionamento. Para testar o caso de pagamento bem-sucedido, autentique o pagamento na página de redirecionamento. O PaymentIntent fará a transição de requires_ para succeeded.
Para testar o que acontece quando a autenticação do usuário falha, use as chaves de API de teste e visualize a página de redirecionamento. Nessa página, clique em Falhar pagamento de teste. O PaymentIntent mudará de requires_ para requires_.
Além de passar preços recorrentes, você pode adicionar preços avulsos no modo subscription. Esses preços somente estão na fatura inicial criada pela assinatura. Esse recurso é útil para adicionar tarifas de configuração ou outras tarifas avulsas associadas a uma assinatura.
Além de passar IDs de preços existentes, você pode definir o preço do item na criação da sessão do Checkout. Defina um produto e crie uma sessão do Checkout passando o ID do produto em price_data com os dados de unit_, currency e recurring:
Se você também precisa criar produtos em linha, use product_data:
Se você já tiver criado um objeto Customer para representar um cliente, use o argumento cliente para passar o ID desse cliente ao criar uma sessão do Checkout. Isso garante que todos os objetos criados durante a sessão sejam associados ao objeto Customer correto.
Quando você passa um ID de cliente, a Stripe também usa o e-mail armazenado no objeto Customer para preencher o campo de e-mail na página de checkout. Se o cliente trocar o e-mail na página de checkout, este será atualizado no objeto Customer quando o pagamento for concluído.
Se você já coletou o e-mail do cliente e quer preenchê-lo antecipadamente na sessão de checkout, passe customer_email ao criar uma sessão de checkout.
É possível usar trial_end ou trial_period_days na sessão do Checkout para especificar a duração do período de avaliação. Neste exemplo, usamos trial_ para criar uma sessão do Checkout para uma assinatura com um período de avaliação de 30 dias.
O Checkout exibe as seguintes informações automaticamente para assinaturas com períodos de avaliação:
- Período de avaliação
- Frequência e valor das cobranças após o vencimento da avaliação
Veja mais informações sobre requisitos de conformidade no guia do Billing ou do suporte.
Você pode especificar alíquotas de impostos (sobre vendas, IVA, GST e outros) nas sessões de checkout para aplicar impostos às assinaturas.
- Use alíquotas fixas quando você souber qual a alíquota exata que deve ser cobrada dos clientes antes do início do checkout (por exemplo, você vende apenas para clientes no Reino Unido e sempre cobra 20% de IVA).
- Com a API Prices, você pode usar alíquotas dinâmicas quando precisar de mais dados do cliente (por exemplo, endereço de cobrança ou entrega) para determinar a alíquota a ser cobrada. As alíquotas dinâmicas podem ser atribuídas a regiões diferentes (por exemplo, uma alíquota de 20% de IVA para clientes no Reino Unido e uma alíquota de 7,25% sobre vendas para clientes na Califórnia). A Stripe tenta associar o local do cliente a uma dessas alíquotas.
Você pode usar as exportações de dados da Stripe para preencher as declarações periódicas necessárias para o repasse. Acesse Declarações e remessas fiscais para obter mais informações.
Você pode aplicar cupons a assinaturas em uma sessão do Checkout configurando descontos. Este cupom substitui qualquer cupom no cliente. Se você estiver criando uma assinatura com um cliente existente, qualquer cupom associado ao cliente é aplicado às faturas da assinatura.
Adicionar códigos de promoção voltados para o cliente
Também é possível ativar códigos promocionais resgatáveis pelo usuário utilizando o parâmetro allow_promotion_codes em sessões do Checkout. Com allow_ ativado em uma sessão do Checkout, o Checkout inclui uma caixa de resgate de código de promoção para uso pelos clientes. Crie seus cupons e códigos promocionais no Dashboard ou na API para que seus clientes possam resgatá-los no Checkout.