Pular para o conteúdo
Criar conta ou Entrar
O logotipo da documentação da Stripe
/
Criar contaLogin
Visão geralAtualize sua integração
Pagamentos online
Visão geralEncontre seu caso de usoUsar o Managed Payments
Pagamentos presenciais
Formas de pagamento
Cenários de pagamento
Muito mais que pagamentos

Adicione descontos

Reduza o valor cobrado de um cliente, descontando do subtotal com cupons ou códigos promocionais.

Você pode usar descontos para reduzir o valor cobrado de um cliente. Os cupons e códigos promocionais permitem:

  • Aplicar um desconto a um subtotal da compra
  • Aplicar um desconto a produtos específicos
  • Reduzir uma porcentagem ou um valor fixo do total cobrado
  • Criar códigos promocionais para o cliente, além de cupons a serem oferecidos diretamente ao cliente

Nota

Para usar cupons para dar descontos em assinaturas no Checkout e no Billing, consulte Descontos para assinaturas.

Criar um cupom

Os cupons especificam um valor fixo de desconto. Você pode criar códigos promocionais para os clientes associados a um único cupom. Isso significa que os códigos FALLPROMO e SPRINGPROMO podem apontar para um único cupom de 25% de desconto. Você pode criar cupons no Dashboard ou com a API:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/coupons \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d percent_off=20 \
  -d duration=once

Usar um cupom

Para criar uma sessão com desconto aplicado, passe o ID do cupom no coupon parâmetro da matriz de descontos. O Checkout atualmente aceita até um cupom ou código promocional.

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 "discounts[0][coupon]"=
"{{COUPON_ID}}"
 \
  -d mode=payment \
  --data-urlencode success_url="https://example.com/success"

Configurar um cupom

Os cupons têm os seguintes parâmetros que você pode usar:

  • currency
  • percent_off ou amount_off
  • max_redemptions
  • redeem_by, a data mais recente à qual os clientes podem aplicar o cupom
  • applies_to, limita os produtos aos quais o cupom pode ser aplicado

Nota

O objeto Coupon adiciona descontos a pagamentos avulsos e assinaturas. Alguns parâmetros do objeto Coupon, como duration, se aplicam apenas a assinaturas.

Limitar o uso de resgates

Os valores max_redemptions e redeem_by aplicam-se ao cupom em todos os aplicativos. Por exemplo, você pode restringir um cupom aos primeiros 50 usos, ou fazer com que expire em uma data determinada.

Limitar os produtos elegíveis

Você pode limitar os produtos elegíveis para desconto com o cupom, acrescentando os IDs de produtos ao hash applies_to no objeto Coupon. Todos os códigos promocionais mapeados para este cupom se aplicam apenas à lista de produtos qualificados.

Excluir um cupom

Você pode excluir cupons no Dashboard ou na API. A exclusão de um cupom impede que ele seja aplicado a futuras transações ou clientes.

Criar um código promocional

Códigos promocionais são destinados aos clientes e são criados a partir de cupons. Você pode especificar outras restrições que controlam quando um cliente pode aplicar a promoção. Você pode enviar os códigos aos clientes, que podem inseri-los no checkout para aplicar um desconto.

Para criar um código promocional, especifique um coupon existente e as restrições aplicáveis (limitado a um customer específico, por exemplo). Se você tiver um código específico para atribuir ao cliente (por exemplo, FALL25OFF), defina o code. Se deixar esse campo em branco, a Stripe gerará um code aleatório para você.

O code não diferencia maiúsculas de minúsculas e é exclusivo dentre todos os códigos de promoção ativos para qualquer cliente. Por exemplo:

  • Você pode criar vários códigos promocionais restritos a determinados clientes usando o mesmo code, mas não pode reutilizar esse code em uma promoção resgatável por qualquer cliente.
  • Se você criar um código promocional resgatável por qualquer cliente, não será possível criar outro código promocional ativo com o mesmo code.
  • Você pode criar um código promocional com code: NEWUSER, inativá-lo com o parâmetro active: false e criar um novo código promocional com code: NEWUSER.

Os códigos promocionais podem ser criados na seção de cupons do Dashboard ou com a API:

Command Line
cURL
No results
curl https://api.stripe.com/v1/promotion_codes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d coupon={{COUPON_ID}} \
  -d code=VIPCODE

Usar um código promocional

Ative códigos promocionais resgatáveis pelo cliente com o parâmetro allow_promotion_codes em uma Sessão do Checkout. Isso habilita um campo no Checkout que permite que os clientes insiram códigos promocionais.

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_data][unit_amount]"=2000 \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d allow_promotion_codes=true \
  --data-urlencode success_url="https://example.com/success"

Configurar um código promocional

Para cada código promocional, você pode personalizar clientes e resgates qualificados e outros limites.

Limitar por cliente

Para limitar uma promoção a um cliente específico, especifique um cliente ao criar o código promocional. Se nenhum cliente for especificado, qualquer cliente poderá resgatar o código.

Limitar por primeiro pedido

Você também pode limitar o código promocional aos novos clientes com restrictions.first_time_transaction. Se o customer não estiver definido, ou se um customer definido não tiver nenhum pagamento ou fatura não nula faturas anterior, essa transação será considerada a primeira.

Nota

Sessões que não criam Customers, e em vez disso criam Guest Cuscomers no Dashboard. Os códigos promocionais limitados a novos clientes ainda são aceitos para essas sessões.

Definir um valor mínimo

Com códigos promocionais, você pode definir um valor mínimo de transação para desconto qualificado configurando minimum_amount e minimum_amount_currency. Como as restrições por código promocional são verificadas no momento do resgate, o valor mínimo da transação se aplica somente ao pagamento inicial de uma assinatura.

Personalizar validades

Você pode configurar uma data de validade para o código promocional usando expires_at. Se o cupom correspondente já tiver a configuração redeem_by, a data de validade do código promocional não pode ser posterior à do cupom. Se promotion_code[expires_at] não for especificado, a data redeem_by do cupom preencherá expires_at automaticamente.

Por exemplo, você pretende aceitar um cupom por um ano, mas quer que ele seja resgatado pelo cliente no máximo uma semana após o recebimento. Você pode definir coupon[redeem_by] com a data de daqui a um ano e definir cada promotion_code[expires_at] uma semana após a criação.

Limitar resgates

Você pode limitar o número de resgates usando max_redemptions, que funciona de forma semelhante ao parâmetro do cupom. Se o cupom correspondente já tiver a configuração max_redemptions, o max_redemptions do código promocional não pode ser maior do que o do cupom.

Por exemplo, você tem um cupom de liquidação de estação válido para os primeiros 50 clientes, mas a promoção de inverno só pode usar 20 desses resgates. Nesse caso, você pode definir coupon[max_redemptions]: 50 e promotion_code[max_redemptions]: 20.

Promoções inativas

Você pode definir se um código promocional está resgatável com o parâmetro active. Mas se o cupom correspondente a um código promocional ficar inválido, todos os seus códigos promocionais serão permanentemente desativados. Da mesma forma, se um código promocional atingir o valor de max_redemptions ou o prazo expires_at, ele será permanentemente desativado. Não é possível reativar esses códigos promocionais.

Excluir promoções

Você pode excluir promoções no Dashboard ou na API. A exclusão de uma promoção impede que ela seja aplicada a futuras transações ou clientes.