Pular para o conteúdo
Criar conta ou Entrar
O logotipo da documentação da Stripe
/
Pergunte à IA
Criar contaLogin
Comece já
Pagamentos
Receita
Plataformas e marketplaces
Gestão de valores
Recursos para desenvolvedores
APIs e SDKsAjuda
Visão geral
Sobre os pagamentos da Stripe
Atualize sua integração
Análise de pagamentos
Pagamentos online
Visão geralEncontre seu caso de usoUsar o Managed Payments
Usar Payment Links
Usar uma página de checkout predefinida
    Visão geral
    Guias de início rápido
    Como funciona o Checkout
    Personalizar a aparência
      Personalize a aparência
      Personalize texto e políticas
      Personalizar marcas de cartão
    Coletar informações adicionais
    Colete impostos
    Atualizar checkout dinamicamente
    Gerencie seu catálogo de produtos
    Assinaturas
    Gerenciar formas de pagamento
    Permita que os clientes paguem na moeda local
    Adicione descontos, upsells e itens opcionais
    Configurar pagamentos futuros
    Salvar dados de pagamento durante o pagamento
    Após o pagamento
    Migrar do Checkout antigo
    Migrar o Checkout para usar Prices
Criar uma integração personalizada com o Elements
Crie uma integração no aplicativo
Pagamentos presenciais
Terminal
Formas de pagamento
Adicionar formas de pagamento
Gerenciar formas de pagamento
Checkout mais rápido com o Link
Cenários de pagamento
Gerenciar várias moedas
Fluxos de pagamento personalizados
Aquisição flexível
Orquestração
Muito mais que pagamentos
Abra sua empresa
Cripto
Comércio agêntico
Financial Connections
Climate
Entenda as fraudes
Proteção contra fraudes do Radar
Gerenciar contestações
Verificar identidades
Estados Unidos
Português (Brasil)
Página inicialPagamentosUse a prebuilt checkout pageCustomize look and feel

Personalize texto e políticas

Personalize o texto mostrado para os clientes e as políticas exibidas pelo Checkout.

Quando os clientes pagam com o Stripe Checkout usando uma página de pagamentos hospedada ou um formulário de pagamentos integrados, você pode apresentar texto adicional, como prazos de envio e processamento.

Aviso

Você não tem permissão para usar esse recurso para criar um texto personalizado que viole ou crie ambiguidades com o texto gerado pela Stripe no Checkout, com as obrigações sob seu contrato da Stripe, as políticas da Stripe e as leis aplicáveis.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d "line_items[0][price]"=
"{{PRICE_ID}}"
\ -d "line_items[0][quantity]"=1 \ -d mode=payment \ -d "shipping_address_collection[allowed_countries][0]"=US \ --data-urlencode "custom_text[shipping_address][message]"="Please note that we can't guarantee 2-day delivery for PO boxes at this time." \ --data-urlencode "custom_text[submit][message]"="We'll email you instructions on how to get started." \ --data-urlencode "custom_text[after_submit][message]"="Learn more about **your purchase** on our [product page](https://www.stripe.com/)." \ --data-urlencode success_url="https://example.com/success" \ --data-urlencode cancel_url="https://example.com/cancel"
Texto personalizado próximo à coleta do endereço de entrega

Texto personalizado próximo aos campos de coleta do endereço de entrega

Texto personalizado acima do botão de pagamento

Texto personalizado acima do botão Pagar

Texto personalizado abaixo do botão de pagamento

Texto personalizado após o botão Pagar

Seu texto personalizado pode ter até 1.200 caracteres. No entanto, o Stripe Checkout é otimizado para conversão e acrescentar informações adicionais pode afetar sua taxa de conversão. Você pode colocar texto em negrito ou inserir um link usando a sintaxe de markdown.

Personalizar o botão Enviar

Para alinhar melhor o Checkout com o modelo de negócio, configure o texto exibido no botão de envio do Checkout para compras únicas.

Defina um submit_type na sessão. Neste exemplo (para uma doação de US$ 5,00), o botão de envio do Checkout customizado exibe Doar US$ 5,00. Consulte a referência da API para ver uma lista completa das opções de submit_type.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d submit_type=donate \ -d "line_items[0][price]"=
"{{PRICE_ID}}"
\ -d "line_items[0][quantity]"=1 \ -d mode=payment \ --data-urlencode success_url="https://example.com/success" \ --data-urlencode cancel_url="https://example.com/cancel"

Idiomas aceitos e versões traduzidas

Por padrão, o Checkout detecta a localidade do navegador do cliente e exibe uma versão traduzida da página no idioma escolhido, se a Stripe aceitá-la. Você substituir a localidade do navegador para o Checkout passando o parâmetro locale durante a criação de uma sessão do Checkout.

O Checkout também usa a localidade para formatar números e moedas. Por exemplo, na venda de um produto com preço em euros com a localidade definida como auto, um navegador configurado para usar inglês (en) mostra “€25.00” e outro configurado para usar alemão (de) mostra “25,00 €”.

Personalizar políticas e dados de contato

Você pode mostrar os dados de contato e as políticas de devolução, reembolso e jurídicas aos clientes no Checkout. Acesse Configurações do Checkout para definir as informações a serem exibidas, como:

  • Detalhes das políticas de devolução e reembolso
  • O número de telefone, e-mail e site do seu suporte
  • Links para os seus termos de serviço e a sua política de privacidade

A apresentação dessas informações pode aumentar a confiança dos compradores e reduzir o abandono de carrinhos.

Configurar políticas jurídicas e de suporte

Para adicionar dados de contato às sessões em Configurações do Checkout, habilite Dados de contato. Da mesma forma, habilite Políticas jurídicas para adicionar links dos Termos de serviço e da Política de privacidade às sessões. Se você precisa que os clientes aceitem implicitamente suas políticas jurídicas quando concluírem o checkout, marque a caixa de seleção Exibir concordância com os termos jurídicos.

Você precisa adicionar links para os dados de contato e as políticas jurídicas nas Configurações de dados públicos.

As visualizações a seguir mostram como o Checkout exibe um diálogo com dados de contato de suporte, links para as políticas jurídicas da loja e informações sobre os termos de pagamento.

Uma página de checkout com dados de contato.

Visualização de dados de contato no Checkout.

Uma página de checkout com políticas jurídicas.

Visualização de políticas jurídicas no Checkout.

Configurar políticas de devolução e reembolso

Para exibir suas políticas de devolução, reembolso ou troca, habilite Políticas de devolução e reembolso. Embora as empresas que vendem mercadorias físicas usem políticas de devolução, as que vendem mercadorias físicas personalizadas ou digitais costumam adotar políticas de reembolso. Como não são mutuamente exclusivas, você pode selecionar as duas opções quando sua empresa vende as duas categorias de mercadorias. Os detalhes de devolução e reembolso podem ser editados para especificar:

  • Se você aceita devoluções, reembolsos ou trocas
  • Se devoluções, reembolsos ou trocas são gratuitos ou estão sujeitos a uma tarifa
  • Quantos dias após a compra você aceita devoluções, reembolsos ou trocas
  • Como os clientes podem devolver itens recebidos
  • Se você aceita devoluções nas lojas físicas
  • Um link para a política completa de devolução e reembolso
  • Uma mensagem personalizada

Se você aceita devoluções, reembolsos ou trocas gratuitas, o Checkout destaca a política para os clientes.

As visualizações a seguir mostram como o Checkout exibe uma política de devolução. Neste exemplo, os produtos podem ser devolvidos por remessa ou nas lojas físicas até 60 dias após a compra para obter um reembolso completo (ou troca). Informações semelhantes podem ser exibidas para reembolsos.

Visualização de políticas de devolução no Checkout

Visualização das políticas de devolução no Checkout.

Visualização de um destaque de política no Checkout

Visualização de um destaque de política no Checkout.

Colete um contrato de termos de serviço

Muitas vezes, as empresas exigem que os clientes concordem com os termos de serviço antes de pagar. Isso pode depender do tipo de produto ou assinatura. O Checkout ajuda a obter a concordância necessária exigindo que seus termos sejam aceitos pelo cliente antes de pagar.

Coletar contrato de termos de serviço

Coletar contrato de termos de serviço

Você pode coletar um contrato de termos de serviço com o Stripe Checkout ao criar uma sessão:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d "line_items[0][price]"=
"{{PRICE_ID}}"
\ -d "line_items[0][quantity]"=2 \ -d mode=payment \ --data-urlencode success_url="https://example.com/success" \ --data-urlencode cancel_url="https://example.com/cancel" \ -d "consent_collection[terms_of_service]"=required \ --data-urlencode "custom_text[terms_of_service_acceptance][message]"="I agree to the [Terms of Service](https://example.com/terms)"

Quando consent_collection.terms_of_service='required', o Checkout exibe dinamicamente uma caixa de seleção para coletar o contrato de termos de serviço do cliente. Se consent_collection.terms_of_service='none', o Checkout não exibirá a caixa de seleção e não exigirá que os clientes aceitem os termos de serviço. Antes de exigir a concordância com seus termos, defina o URL dos termos de serviço nos dados públicos da sua empresa. A definição de um URL de política de privacidade é opcional. O Checkout também direciona para sua política de privacidade quando um URL para essa política é definido em seus dados públicos.

Após um cliente concluir o checkout, você pode verificar se ele aceitou seus termos de serviço observando o objeto Sessão no webhook checkout.session.completed ou recuperando a Sessão usando a API. Quando os termos são aceitos, o campo consent.terms_of_service da sessão é definido como accepted.

Você pode personalizar o texto que aparece ao lado da caixa de seleção usando custom_text.terms_of_service_acceptance. Você precisa definir consent_collection.terms_of_service='required'. Para usar seus próprios termos, insira um link de markdown. Por exemplo: I agree to the [Terms of Service](https://example.com/terms)

Aviso

Consulte seus assessores jurídicos e de conformidade antes de fazer qualquer alteração neste texto. Você não pode usar este recurso para exibir texto personalizado que viole ou crie ambiguidades com o texto gerado pela Stripe no Checkout, as obrigações decorrentes do seu contrato da Stripe, as políticas da Stripe e as leis aplicáveis.

Obter consentimento para e-mails promocionais

Você pode enviar e-mails promocionais para informar os clientes sobre novos produtos e para compartilhar cupons e descontos. Antes de fazer isso, você precisa coletar o consentimento deles para receber e-mails promocionais.

Personalize o contrato de reutilização de formas de pagamento e os termos de assinatura

Quando uma sessão está no modo setup ou subscription, ou no modo payment com setup_future_usage definido, o Checkout exibe uma mensagem sobre a reutilização da forma de pagamento do cliente. A mensagem pode incluir dados específicos da forma de pagamento selecionada. Você pode ocultar ou personalizar o texto padrão, mas não o texto específico da forma de pagamento.

Para uma assinatura, o texto personalizado pode incluir informações como as seguintes:

  • Um link para seus termos de assinatura
  • Um link para o portal do cliente
  • Mecanismos e políticas de cancelamento
Exibição do contrato de reutilização da forma de pagamento padrão no modo de assinatura

Forma de pagamento padrão Reutilizar contrato no modo de assinatura

Aviso

Ao personalizar este texto, você será responsável por manter a conformidade, o que inclui atualizá-lo à medida que as regras das bandeiras de cartão e os regulamentos locais mudam. Não use esse recurso sem consultar sua equipe jurídica ou definir um texto personalizado com informações sobre a reutilização da forma de pagamento. Certifique-se de que seu texto personalizado cubra todos os modos que você planeja aceitar.

Para ocultar o texto do contrato de reutilização da forma de pagamento, defina consent_collection.payment_method_reuse_agreement.position='hidden'. O Checkout não exibirá a linguagem padrão que controla a reutilização da forma de pagamento. Para definir seu próprio texto no lugar do idioma padrão da Stripe, defina custom_text.after_submit.message. Você também pode usar custom_text.submit ou custom_text.terms_of_service_acceptance para exibir sua própria versão desse idioma.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d "line_items[0][price]"=
"{{PRICE_ID}}"
\ -d "line_items[0][quantity]"=1 \ -d mode=subscription \ --data-urlencode success_url="https://example.com/success" \ --data-urlencode cancel_url="https://example.com/cancel" \ -d "consent_collection[payment_method_reuse_agreement][position]"=hidden \ --data-urlencode "custom_text[after_submit][message]"="You can cancel your subscription at any time by [logging into your account](https://www.example.com/)"
Esta página foi útil?
SimNão
  • Precisa de ajuda? Fale com o suporte.
  • Confira nosso changelog.
  • Dúvidas? Fale com a equipe de vendas.
  • LLM? Read llms.txt.
  • Powered by Markdoc