# Testar o Stripe Invoicing

Saiba como testar sua integração do Invoicing.

Para saber mais sobre como testar uma integração, consulte a [página de testes](https://docs.stripe.com/testing.md) de uso geral da Stripe. Para uma integração do Subscriptions, acesse [Teste do Stripe Billing](https://docs.stripe.com/billing/testing.md).

Use estes cenários comuns para testar sua integração de faturamento antes de colocá-la em modo de produção.

## Testar notificações de webhook

A Stripe aciona notificações de evento quando o [status de uma *fatura* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice) muda de status](https://docs.stripe.com/invoicing/integration/workflow-transitions.md#status-transitions-endpoints). Depois de configurar a Stripe CLI e vincular sua conta Stripe, você pode testar webhooks da seguinte forma:

- Acionar notificações de evento com a [Stripe CLI](https://docs.stripe.com/stripe-cli.md). Veja uma lista completa de [tipos de evento de fatura](https://docs.stripe.com/api/events/types.md#event_types-invoice.created).

- Usar o Dashboard para [criar faturas](https://dashboard.stripe.com/test/invoices/create) em uma *área restrita* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes).

Você pode adicionar um endpoint e ver os eventos recebidos acessando a guia [Webhooks](https://dashboard.stripe.com/workbench/webhooks) em [Workbench](https://docs.stripe.com/workbench.md).

### Testar eventos com dados falsos

Usando o Stripe CLI para acionar eventos, você pode ver notificações de evento no seu servidor à medida que chegam. Isso significa que você pode verificar sua integração de webhook diretamente, sem dificuldades como túneis de rede ou firewalls. Quando você usa o Stripe CLI, o evento que seu webhook recebe contém dados falsos que não se correlacionam com as informações da fatura.

### Testar eventos com dados reais

A maneira mais confiável de testar notificações de webhook é criar faturas de teste para clientes existentes e gerenciar os eventos correspondentes.

## Testar falhas de pagamento

Para acionar falhas de pagamento de faturas, você pode usar os números de cartão de crédito de teste em [Pagamentos recusados](https://docs.stripe.com/testing.md#declined-payments). Se quiser simular um pagamento recusado de um cartão anexado a um cliente, use **4000 0000 0000 0341** como forma de pagamento padrão.

Dependendo da sua [configuração de novas tentativas](https://docs.stripe.com/invoicing/automatic-collection.md), pode ser necessário aguardar um dia ou mais para ver a primeira nova tentativa. Para ver o que acontece se a nova tentativa for bem-sucedida, use esse período de espera para atualizar a forma de pagamento do cliente para um cartão de teste funcional.

## Testar pagamentos que exigem 3D Secure

Use o cartão [**4000 0027 6000 3184**](https://docs.stripe.com/testing.md#regulatory-cards) para simular o acionamento do 3D Secure em faturas. Quando a Stripe aciona uma autenticação do 3D Secure, é possível testar a autenticação ou a falha na tentativa de pagamento na caixa de diálogo do 3DS que aparecer. Se o pagamento for autenticado corretamente, a fatura é paga. Quando uma tentativa de pagamento falha, a tentativa de autenticação é malsucedida e a fatura permanece `open`.

## Testar pagamentos com transferência bancária

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

1. Crie uma fatura no modo de testmode com o método de cobrança definido como `send_invoice` e a matriz `payment_settings[payment_method_types]` definida como `[customer_balance]`.

1. Encontre a fatura no Dashboard e clique em **Enviar**. Isso gera um número de conta bancária virtual único para o seu cliente.

1. Recupere o número exclusivo da conta bancária virtual do seu cliente usando a [API Customer Balance Funding Instructions](https://docs.stripe.com/payments/customer-balance/funding-instructions.md#create-funding-instructions). Você também pode encontrar os dados bancários virtuais do cliente na página da fatura hospedada e no PDF.

## Testar verificação de ID fiscal de clientes

Use estes IDs fiscais “mágicos” para acionar determinadas condições de verificação em ambientes de teste. O tipo de ID fiscal deve ser Australian Business Number (ABN), EU VAT Number ou UK Value-Added-Tax (GB VAT) number.

| Número      | Tipo                                             |
| ----------- | ------------------------------------------------ |
| `000000000` | Verificação bem-sucedida                         |
| `111111111` | Verificação malsucedida                          |
| `222222222` | A verificação permanece pendente indefinidamente |