# 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. ![](https://b.stripecdn.com/docs-statics-srv/assets/hosted-invoice-page.3f79f6d4ded5d51047ae2b16270c2c42.png) 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: ```missingLanguage 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. > 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. #### Dashboard Quando uma URL expira, ela não carrega mais o recurso pretendido. Em vez disso, a Stripe redireciona os clientes faturados para uma página que informa que a URL expirou e orienta a entrar em contato com a empresa. Essa página também fornece as informações de contato da empresa. > 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. #### API Embora URLs vencidos normalmente redirecionem (302) para uma página de recuperação, os URLs de download de PDF são exceções. Se a Stripe detectar que um cliente que não é de navegador (por exemplo, cURL) solicitou URLs de download de PDF, nós retornaremos um erro 400 com uma resposta *URL vencido* no corpo. Isso permite às integrações detectar com mais facilidade quando um URL expirou e obter um novo URL válido solicitando novamente o recurso de fatura ou nota de crédito. ## 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](https://docs.stripe.com/api/invoices/object.md#invoice_object-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](https://dashboard.stripe.com/settings/billing/invoice) 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](https://dashboard.stripe.com/account/branding) 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](https://docs.stripe.com/invoicing/payment-methods.md). É 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](https://dashboard.stripe.com/settings/billing/invoice). Você também pode selecionar a forma de pagamento para cada fatura quando estiver [criando uma fatura](https://dashboard.stripe.com/invoices/create) 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). > Por exemplo, o regulamento de *Autenticação Forte de Cliente* (Strong Customer Authentication (SCA) is a regulatory requirement in effect as of September 14, 2019, that impacts many European online payments. It requires customers to use two-factor authentication like 3D Secure to verify their purchase)(SCA) na Europa exige que os clientes confirmem o pagamento com *3D Secure* (3D Secure (3DS) provides an additional layer of authentication for credit card transactions that protects businesses from liability for fraudulent card payments)(3DS). Nesse caso, a página da fatura hospedada exibe o modal de confirmação do pagamento ao seu cliente. > Se um cliente tiver uma [forma de pagamento padrão](https://docs.stripe.com/api/customers/object.md#customer_object-invoice_settings-default_payment_method), poderá usá-la na página da fatura hospedada mesmo que a configuração da forma de pagamento da fatura não a inclua. ## Persistência da forma de pagamento > 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](https://docs.stripe.com/api/payment_methods/object.md#payment_method_object-allow_redisplay) de `always` são exibidas e disponibilizadas para uso. > Os clientes recebem apenas 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. 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](https://docs.stripe.com/sources.md) obsoleta para faturas ou usa [parcelamentos do cartão](https://docs.stripe.com/payments/installments.md), 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](https://docs.stripe.com/api/payment_methods/object.md#payment_method_object-allow_redisplay) é definido como `always` se o cliente marcar a caixa de seleção e `limited` se não marcar. 1. **Nunca**: as formas de pagamento usadas em faturas avulsas não são salvas. - [allow_redisplay](https://docs.stripe.com/api/payment_methods/object.md#payment_method_object-allow_redisplay) está definido como `limited`. 1. **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](https://docs.stripe.com/api/payment_methods/object.md#payment_method_object-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](https://dashboard.stripe.com/settings/billing/invoice) 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](https://docs.stripe.com/api/accounts.md). Quando criar ou atualizar uma `Account`, defina a propriedade `settings.invoices.hosted_payment_method_save` como `never`, `offer` ou `always`. ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -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 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](https://docs.stripe.com/invoicing/hosted-invoice-page/scheduled-payments.md) e o cliente optar por agendar o pagamento da fatura, a forma de pagamento será sempre salva. - Se [as parcelas do cartão ](https://docs.stripe.com/payments/installments.md) 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](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-setup_future_usage) de `off_session` ou `on_session`, a forma de pagamento é sempre salva. - Se a sua integração utiliza a [API Sources](https://docs.stripe.com/sources.md) (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 Pricing](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md)permite 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](https://dashboard.stripe.com/settings/adaptive-pricing) no Dashboard. ## Informações públicas de suporte As faturas incluem todas as informações públicas especificadas em [Dados comerciais públicos](https://dashboard.stripe.com/settings/public), 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.