Acrescentar descontos a pagamentos avulsos
Você pode usar descontos no Checkout para reduzir o valor cobrado do cliente em um pagamento avulso. Cupons e códigos promocionais são flexíveis e podem ser definidos e usados de várias formas. Eles podem:
- 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
Para usar cupons para dar descontos em assinaturas no Checkout e no Billing, consulte Descontos para assinaturas.
Cupons
Os cupons especificam um valor fixo de desconto. Você pode criar códigos de promoção 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.
Criar um cupom
Os cupons são criados no Dashboard ou com a API:
Para criar uma sessão com desconto aplicado, passe o ID do cupom no parâmetro coupon
do conjunto descontos. O Checkout aceita no máximo um cupom ou código promocional.
Configurar um cupom
Os cupons têm os seguintes parâmetros, que podem ser usados para pagamentos avulsos:
id
(um identificador exclusivo do cupom)currency
percent_off
ouamount_off
max_redemptions
redeem_by
applies_to
, limita os produtos aos quais o cupom pode ser aplicado
Observação
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 usos. Por exemplo, você pode restringir o cupom a 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 esse cupom se aplicam apenas à lista de produtos elegíveis.
Excluir um cupom
Você pode excluir cupons no Dashboard ou pela API. Excluir um cupom impede que ele seja aplicado a futuras transações ou clientes.
Códigos promocionais
Os códigos promocionais são destinados aos clientes e são criados com base em cupons. Você também pode especificar restrições adicionais para controlar quando o cliente pode aplicar a promoção. Esses códigos podem ser compartilhados com os clientes, que os informam no Checkout para aplicar o desconto.
Criar um código promocional
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 seu cliente (ex.: FALL25OFF
), defina code
. Se esse campo ficar em branco, vamos 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 essecode
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âmetroactive: false
, e então criar um novo código promocional comcode: NEWUSER
.
Os códigos promocionais podem ser criados na seção de cupons do Dashboard ou com a API:
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 usuários insiram códigos promocionais.
Configurar um código promocional
Os parâmetros do objeto Promotion Code permitem personalizar os clientes elegíveis, os resgates e outros limites.
Limitar por cliente
Para limitar uma promoção a um cliente específico, especifique um customer
ao criar o código promocional. Sem nenhum cliente especificado, o código poderá ser resgatado por qualquer cliente.
Limitar por primeiro pedido
Você também pode limitar o código promocional aos novos clientes com o parâmetro first_time_transaction
do atributo restrictions
. Se o customer
não estiver definido, ou se um customer
definido não tiver nenhum pagamento ou fatura não nula invoices, será considerado como primeira transação.
Observação
Sessões que não criam clientes, e em vez disso criam clientes convidados no Dashboard. Os códigos de promoção 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 aplicação do desconto, com as propriedades minimum_amount
e minimum_amount_currency
. Como as restrições por código promocional são verificadas no momento da aplicação, o valor mínimo da transação se aplica somente ao pagamento inicial em caso de assinaturas.
Personalizar a validade
Você pode configurar uma data de validade para o código promocional com 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 estiver especificado, a data em redeem_by
do cupom será aplicada automaticamente também a expires_at
.
Por exemplo, seu plano é aceitar um cupor por um ano, mas você quer que ele seja resgatado pelo cliente em até uma semana após o recebimento. O parâmetro coupon[redeem_by]
deve ser daqui a um ano, e cada promotion_code[expires_at]
deve ser uma semana após a criação.
Limitar os 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 parâmetro 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 temporada, resgatável pelos primeiros 50 clientes, mas a promoção de inverno só pode usar 20 desses resgates. Nessa situação, configure coupon[max_redemptions]: 50
e promotion_code[max_redemptions]: 20
.
Promoções inativas
Você pode definir se um código promocional pode ser resgatado atualmente com o parâmetro active
. Mas se o cupom correspondente de um código promocional ficar inválido, todos os seus códigos promocionais serão permanentemente desativados. Da mesma forma, um código promocional ficará permanentemente inativo se atingir o número de max_redemptions
ou o prazo expires_at
. Não é possível reativar esses códigos promocionais.
Excluir promoções
Você pode excluir promoções no Dashboard ou pela API. A exclusão de uma promoção impede que ela seja aplicada a futuras transações ou clientes.