Página da fatura hospedada

A página da fatura hospedada oferece um URL seguro e privado onde os clientes podem:

• Ver os detalhes, valores e o status da fatura.
• Pagar a fatura com as formas de pagamento habilitadas.
• Baixar cópias em PDF da fatura e do recibo.

Um exemplo de página da fatura hospedada

A Stripe atribui a todas a todas as faturas um URL único que você pode enviar ao seu cliente. Nós hospedamos essas faturas, o que significa que você pode coletar os pagamentos com segurança sem qualquer código de implementação adicional.

URLs de fatura

Quando você cria e envia uma fatura, a Stripe gera um URL único para a página da fatura hospedada. O URL inclui um identificador seguro, longo e aleatório, como no exemplo a seguir:

https://invoice.stripe.com/i/acct_abcdefghijklmno/test_YWNjdF8xRGZ3UzJDbENJS2xqV3ZzLF9MNGJvMDBzY0xFQ2c1cG1QZzZ6Wk5jV0RXR2lOS1V6LDM0Mjk3NjEz0200wpYOWgBE?s=em

Os URLs de fatura vencem 30 dias após a data de validade. Se a fatura não tiver uma data de validade, a fatura vence 30 dias depois de finalizar. Em todos os casos, a janela de validade nunca é superior a 120 dias.

Links de e-mail de fatura

Você pode incluir um link no e-mail da fatura para a página da fatura hospedada. Quando estiver habilitado, o URL da página da fatura hospedada será exibido:

• Nos e-mails de faturas como link de pagamento.
• No rodapé de PDFs de faturas.
• Na resposta da API Invoice como hosted_invoice_url

Para habilitar a página da fatura hospedada em todas as faturas recém-criadas, marque a caixa de seleção Incluir um link hospedado pela Stripe para uma página de pagamento da fatura no e-mail da fatura em Configurações da fatura no Dashboard.

Quando enviar uma fatura, você pode usar a seção Entrega para que a Stripe envie automaticamente um e-mail ao seu cliente com a página da fatura hospedada ou gere uma página de fatura hospedada que você mesmo pode enviar. Para enviar pessoalmente a página da fatura hospedada, crie a fatura e copie o link para enviar ao cliente.

Personalização da página

A página da fatura hospedada é personalizada com:

• Cor da marca
• Logotipo
• Ícone

Personalize essas configurações de marca no Dashboard.

Definir as formas de pagamento permitidas

Na página da fatura hospedada, você pode configurar faturas para permitir pagamentos com uma ou mais formas de pagamento aceitas. É possível definir padrões a serem aplicados a todas as faturas recém-criadas com a configuração de forma de pagamento padrão da fatura. Você também pode selecionar a forma de pagamento para cada fatura quando estiver criando uma fatura no Dashboard.

Com a página da fatura hospedada, você pode exibir ao cliente a lista das formas de pagamento aceitas para permitir que ele escolha a forma de pagamento mais adequada. Além disso, você pode habilitar a página da fatura hospedada para proporcionar ao cliente o benefício de ter a Stripe gerenciando fluxos complexos de pagamento e autenticação (sem qualquer esforço adicional de implementação por sua parte).

Persistência da forma de pagamento

Você pode configurar o modo como os dados da forma de pagamento inseridos pelos clientes na página da fatura hospedada serão salvos para uso futuro. Por padrão, a Stripe não armazena as formas de pagamento usadas para pagamentos avulsos, a menos que o cliente opte por usar uma caixa de seleção exibida na página da fatura hospedada.

Quando um cliente retorna à página da fatura hospedada, formas de pagamento salvas com allow_redisplay de always são exibidas e disponibilizadas para uso.

Opções de configuração

As configurações a seguir estão disponíveis para armazenar formas de pagamento usadas para pagamentos de faturas avulsas na página de faturas hospedadas.

1. Oferecer: As formas de pagamento de faturas avulsas são salvas somente se o cliente marcar uma caixa de seleção exibida antes de concluir o pagamento. (Padrão para novas contas criadas após 30 de maio de 2025.)
   • Se a sua integração usa a API Sources obsoleta para faturas ou usa parcelamentos do cartão, essa caixa de seleção não será exibida e a forma de pagamento não será salva porque o cliente não pode dar consentimento.
   • Tenha termos em vigor com o cliente sobre como você planeja usar as formas de pagamento que ele decidir salvar.
   • allow_redisplay é definido como always se o cliente marcar a caixa de seleção e limited se não marcar.
2. Nunca: as formas de pagamento usadas em faturas avulsas não são salvas.
   • allow_redisplay está definido como limited.
3. Sempre: as formas de pagamento usadas em faturas avulsas são sempre salvas, sem perguntar ao cliente.
   • Salvar formas de pagamento sem permissão explícita do cliente pode violar as regulamentações de privacidade em várias jurisdições. Antes de selecionar esta opção, verifique se ela está de acordo com as leis locais.
   • allow_redisplay está definido como limited.

Selecione uma configuração

Dashboard

Para configurar formas de pagamento de salvamento, use os controles da seção Termos de pagamento padrão da página de configurações de fatura do seu Dashboard. Para ativar o salvamento de formas de pagamento, selecione Salvar dados de pagamento do cliente. Para permitir salvar sem perguntar primeiro ao cliente, desmarque Perguntar aos clientes antes de salvar os dados de pagamento.

API

Você pode configurar formas de pagamento de salvamento para contas conectadas usando a API Accounts. Quando criar ou atualizar uma Account, defina a propriedade settings.invoices.hosted_payment_method_save como never, offer ou always.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "settings[invoices][hosted_payment_method_save]"=offer

Limitações

Se a opção de salvar uma forma de pagamento estiver habilitada, a página da fatura hospedada salvará apenas formas de pagamento reutilizáveis. Essas formas de pagamento incluem:

• Cartões
• Link
• Débito pré-autorizado
• Débito automático BECS
• Débito automático Bacs
• Débito automático SEPA
• Débito automático ACH

Substituições

Alguns casos anulam essa configuração, dependendo das propriedades da fatura e da conta. Isso só se aplica a formas de pagamento reutilizáveis (veja a lista acima).

• Se a fatura estiver vinculada a uma assinatura, a forma de pagamento sempre será salva.
• Se a sua conta Stripe permite que os clientes agendem pagamentos e o cliente optar por agendar o pagamento da fatura, a forma de pagamento será sempre salva.
• Se a fatura anexada PaymentIntent tiver o valor setup_future_usage de off_session ou on_session, a forma de pagamento é sempre salva.
• Se a fatura usar parcelas no cartão ou se sua integração usar a API Sources obsoleta para receber pagamentos de faturas hospedadas, a configuração offer não salva as formas de pagamento do cliente. Esses casos não aceitam a caixa de seleção de consentimento do cliente, de modo que o cliente não pode fornecer consentimento.

Informações públicas de suporte

As faturas incluem todas as informações públicas especificadas em Dados comerciais públicos, como seu endereço de e-mail de suporte ou site da empresa. Usando essas configurações, você também pode optar por incluir um número de telefone de suporte em documentos voltados para o cliente, como faturas em PDF e e-mails, ou usar o endereço comercial padrão.