Página da fatura hospedada

Use a página da fatura hospedada para coletar pagamentos dos clientes com segurança.

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.

Nota

Mesmo após o vencimento, qualquer URL que o Dashboard exibir ou um usuário recuperar por meio da API tem validade garantida de, no mínimo, 10 dias.

Quando um URL expira, deixa de carregar o recurso pretendido. Em vez disso, a Stripe redireciona os clientes faturados para uma página que informa que o URL venceu e orienta os clientes a entrar em contato com o comerciante. Essa página também fornece os dados de contato do comerciante.

Nota

Se você enviou uma fatura usando o Dashboard ou a API, qualquer destinatário de e-mail é automaticamente associado com essa fatura. Nesse caso, a Stripe redireciona o usuário para uma página de recuperação onde ele pode inserir o endereço de e-mail para receber uma nova cópia do e-mail original com links não vencidos.

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 ativar a página da fatura hospedada de todas as faturas recém-criadas, marque a caixa de seleção Incluir um link para uma página de pagamento no e-mail da fatura nas configurações da fatura do 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).

Nota

Por exemplo, o regulamento de Autenticação Forte de Cliente(SCA) na Europa exige que os clientes confirmem o pagamento com 3D Secure(3DS). Nesse caso, a página da fatura hospedada exibe o modal de confirmação do pagamento ao seu cliente.

Persistência da forma de pagamento

Cuidado

As leis globais de privacidade são complicadas e diferem conforme a região. Pode ser necessário apresentar os termos e obter os consentimentos necessários ao cliente antes de armazenar a forma de pagamento do cliente. Antes de usar esse recurso, consulte seu advogado para obter orientações específicas para sua empresa.

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.

Nota

Os clientes só são apresentados com formas de pagamento salvas do tipo cartão, Link, ACH Direct Debit ou débito SEPA.

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.

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.
Nunca: as formas de pagamento usadas em faturas avulsas não são salvas.
- allow_redisplay está definido como limited.
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.

Configuração	Salvar dados de pagamento do cliente	Pergunte aos clientes antes de salvar os dados de pagamento
Oferta	Ativados	Ativados
Sempre	Ativados	Desativados
Nunca	Desativados	Desativados

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.

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 tiver uma assinatura anexada, a forma de pagamento só será salva se o cliente não tiver uma forma de pagamento de fatura padrão.
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 as parcelas do cartão estiverem ativadas na fatura e pelo cliente, 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 sua integração utiliza a API Sources (descontinuada) para coletar pagamentos de faturas hospedadas, a configuração offer não salva as formas de pagamento do cliente. Nesses casos, a caixa de seleção de consentimento do cliente não é aceita, então cliente não pode dar o seu consentimento.

Permita que os clientes paguem na moeda local

O Adaptive Pricingpermite que seus clientes paguem em suas moedas locais em mais de 150 países na sua Página de Fatura Hospedada. Com o Adaptive Pricing, a Stripe infere a moeda de apresentação a partir do endereço IP público do cliente, depois calcula automaticamente o preço localizado e gerencia toda a conversão de moedas. Gerencie o Adaptive Pricing para Páginas de Faturas Hospedadas nas suas configurações de pagamento no Dashboard.

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.