Testar o Stripe Billing

Teste detalhadamente toda a integração antes de disponibilizá-la aos clientes ou usá-la em atividades do modo de produção. Use os recursos desta página como complemento das diretrizes organizacionais (por exemplo, manuais de operação, verificações de qualidade ou listas de verificação de desenvolvimento) para ajudar a determinar se a integração está pronta para uso em produção.

Princípios da transição para produção

Antes de usar a integração no modo de produção, confira estas listas de verificação da Stripe:

• Lista de verificação da conta
• Lista de verificação de desenvolvimento
• Lista de verificação do site

Veja a seguir um fluxo de integração típico.

Para integrações de assinaturas e receitas recorrentes, verifique se pelo menos estes componentes funcionam como esperado.

A tabela mostra as notificações de evento para cada componente. A integração pode ser configurada para ouvir esses eventos com webhooks. Leia este guia para saber mais sobre notificações de eventos e testes.

Clocks de teste

Os clocks de teste permitem simular objetos do Billing, como assinaturas, ao longo do tempo no modo de teste. Assim, você não precisa esperar um ano para ver como a integração se comporta no caso de falha de pagamento de uma renovação anual. Não é preciso criar nenhuma programação para usar os clocks de teste: as simulações são criadas no Dashboard. Elas também podem ser acessadas pela API. Saiba mais sobre os clocks de teste e os seus casos de uso.

Testar períodos de avaliação de assinatura

Primeiro, siga estas instruções para começar a usar clocks de teste:

1. Create a test clock
2. Set up your testing simulation
3. Advance the clock’s time
4. Monitor and handle the changes
5. Update the simulation

Em seguida, você pode começar a testar avaliações com clocks de teste. Vamos supor que você deseja que os clientes experimentem o produto gratuitamente em uma avaliação de sete dias antes de começarem a pagar. Para isso, você quer coletar antecipadamente os dados de pagamento. Para simular essa situação usando clocks de teste, siga estas instruções:

• Crie um clock de teste com frozen_time definido como 1º de janeiro.
• Add a customer and include their payment method. In this case, use a 4242424242424242
  test card.
• Crie uma assinatura e adicione um período de avaliação gratuita de sete dias:

• O estado de uma assinatura criada com um período de avaliação gratuita de sete dias é trialing. Com essa assinatura, também é criada uma fatura de US$ 0,00.
• Advance the date to January 5 to see the customer.subscription.trial_will_end event notification. Stripe sends the notification three days before the trial ends. You can use this webhook event to inform your customers that the trial ends soon.
• Adiante a data para 8 de janeiro. O estado da assinatura passa para paid e é criada uma fatura de 50 USD.
• Adiante a data para mais um ciclo (por exemplo, para 8 de fevereiro se a assinatura for mensal) para ver a renovação bem-sucedida da assinatura.

Testar notificações de webhook de assinatura

As integrações de assinatura dependem muito de webhooks. Você configura um endpoint de webhook no servidor e especifica quais eventos quer ouvir. A Stripe emite notificações para eventos como atualização ou cancelamento de assinaturas.

Teste webhooks criando assinaturas de teste reais ou acionando notificações de evento com a Stripe CLI ou no Dashboard.

Depois de configurar a Stripe CLI e vincular a sua conta Stripe, você pode acionar eventos do ciclo de vida da assinatura para testar a integração de webhooks. Quando você usa a Stripe CLI para acionar eventos, pode ver notificações de eventos assim que chegam ao servidor. Dessa forma, é possível verificar a integração de webhooks diretamente, sem túneis ou firewalls de rede.

Quando você usa a Stripe CLI ou o Dashboard para acionar eventos, o webhook recebe eventos com dados simulados, sem relação aos dados da assinatura. A forma mais confiável de testar notificações de webhooks é criar assinaturas de teste reais e gerenciar os eventos correspondentes.

A tabela a seguir descreve os eventos mais comuns relacionados a assinaturas e sugere ações para gerenciar os eventos, quando for o caso.

Testar falhas de pagamento

Use números de cartões de crédito de teste específicos para acionar falhas de pagamento de assinaturas e faturas.

Algumas atualizações de assinatura fazem a Stripe faturar a assinatura e tentar fazer o pagamento imediatamente (essa tentativa de pagamento síncrona pode ocorrer na fatura inicial ou em determinadas atualizações de fatura). Se a tentativa falhar, a assinatura é criada em um status incomplete.

Para testar o que acontece em caso de falha no pagamento de uma assinatura ativa, vincule o cartão 4000 0000 0000 0341 como forma de pagamento padrão do cliente, mas use um período de teste para diferir a tentativa (uma assinatura de alguns segundos ou minutos é suficiente). A assinatura se torna ativa imediatamente, com uma fatura preliminar criada quando o período de avaliação terminar. Leva aproximadamente uma hora para o status da fatura mudar para aberto, nesse momento ocorre a tentativa malsucedida de cobrança do pagamento.

Use clocks de teste para simular o avanço do tempo no modo de teste, o que faz com que os recursos do Billing, como Subscriptions, alterem o estado e acionem eventos de webhook. Isso permite que você veja como sua integração gerencia uma falha de pagamento para uma renovação trimestral ou anual sem esperar um ano.

Testar pagamentos que exigem 3D Secure

Use o cartão 4000 0027 6000 3184 para simular o acionamento do 3D Secure para assinaturas e faturas.

Quando um fluxo de autenticação 3D Secure é acionado, é possível testar a autenticação ou a falha na tentativa de pagamento na caixa de autenticação 3DS que aparecer. Se o pagamento for autenticado corretamente, a fatura é paga. Se a fatura pertencer a uma assinatura com status incomplete, a assinatura fica ativa. Quando uma tentativa de pagamento falha, a tentativa de autenticação é malsucedida e a fatura permanece open.

Testar pagamentos de faturas com transferência bancária

Para testar pagamentos manuais em faturas por meio de transferências bancárias:

1. No modo de teste, crie uma fatura e defina o método de cobrança como send_invoice e defina a matriz payment_settings[payment_method_types] como [customer_balance].
2. Encontre a fatura no Dashboard e clique em Enviar.
3. Seu cliente recebeu um número de conta bancária virtual exclusivo que você pode recuperar usando a API de instruções de financiamento. Os dados bancários virtuais também estão presentes na página da fatura hospedada, assim como no PDF.

Teste a forma de pagamento padrão para faturas e assinaturas

Use IDs de cartão de teste específicos para simular formas de pagamento padrão usadas em assinaturas e faturas.

A forma de pagamento informada precisa definida como a default_payment method para ser vinculada ao cliente da assinatura ou fatura. Por exemplo, se você estiver usando pm_card_visa para criar uma forma de pagamento Visa de teste:

1. Chame o endpoint do PaymentMethod pm_card_visa e o cliente pretendido para a assinatura ou fatura
2. Com o ID da forma de pagamento resultante, crie a assinatura ou fatura com esse ID como o default_payment_method.

Agora a assinatura ou fatura cobrará esta forma de pagamento.

Saiba mais sobre como usar formas de pagamento padrão para assinaturas e faturas.

Testar verificação de ID fiscal de clientes

Use esses códigos fiscais fantasia para acionar determinadas condições de verificação no modo de teste. O tipo de código fiscal precisa ser o Número IVA da UE ou o Número Comercial Australiano (ABN).

Testes automatizados

Você pode configurar testes automatizados para a integração. Para otimizar os testes:

• Conheça a política de retenção de dados para dados relacionados a assinaturas no modo de teste.
• Evite reutilizar recursos como Cupons e Códigos promocionais no decorrer dos testes.
• Use o servidor HTTP simulado da stripe, que é baseado na API da Stripe e reflete melhor o comportamento da API.