Adicional de envios
O Adicional de envios, quando o seu plano o oferece, é uma reserva paga uma vez para quando a cota mensal de envios acabar: como comprar, em que ordem é usada, a validade e o estorno.
Para que serve
Quando o seu plano oferece o Adicional de envios, você compra uma reserva de envios para os dias em que a cota mensal de envios do plano acabar. Não é uma assinatura: cada pacote é um pagamento único, feito pelo dono ou por um admin em Configurações › Cobrança, e os envios da reserva só são usados depois que a cota do plano se esgota.
Quando usar: Para ter folga de envios acima da cota mensal sem trocar de plano e sem assinar nada a mais.
#Como funciona
O Adicional de envios é uma reserva de créditos de envio, um por e-mail. Ela fica guardada na conta do time e não muda a cota do plano: a cota mensal continua a mesma, e a reserva aparece à parte, ao lado dela.
- A reserva só entra em ação depois que a cota mensal de envios do plano acaba. Enquanto a cota tem espaço, nenhum crédito é gasto.
- Um crédito vale um e-mail, contado do mesmo jeito que a cota conta: os e-mails para os endereços de teste não gastam crédito.
- Cada pacote tem a sua validade, em dias, ou não tem validade.
- A compra é um pagamento único: não muda o plano nem cria uma assinatura.
- As campanhas não usam a reserva, mas contam na mesma cota mensal de envios do plano.
- O limite diário de envios do plano continua valendo, mesmo com a reserva.
Veja também: Como a reserva é usada · Cotas de envio.
#Quando dá para comprar
A compra depende do seu plano e da forma como o time é cobrado. Cada situação tem um resultado no cartão Adicional de envios:
| Sua situação | O que acontece |
|---|---|
| Plano com limite mensal de envios, quando o plano oferece o Adicional de envios | O dono e os admins compram em Configurações › Cobrança. O cartão mostra a reserva mesmo antes da primeira compra. |
| Plano com limite mensal de envios, sem pacotes à venda | O cartão mostra a reserva, e Comprar adicional de envios abre a janela com o aviso Nenhum pacote à venda no momento. Fale com o suporte se precisar de mais envios. |
| Plano sem limite mensal de envios (ilimitado) | Não há o que estender, então o cartão não aparece e a compra é recusada. |
| Time cobrado por um parceiro | O time não compra pelo painel: Sua conta é cobrada por um parceiro. O adicional de envios é contratado por ele. |
| Quem não é dono nem admin | Só o dono e os admins compram. A cobrança só aparece para eles. |
| Cobrança fora do ar | O cartão não aparece e a compra não está disponível. O plano atual continua valendo. |
#Comprar
Onde fica: Configurações › Cobrança. Endereço: app.postal.so/settings/billing.
- No cartão Adicional de envios, confira a reserva: Cota mensal do plano (N de M usados e a data em que Renova), Reserva de envios e Pacotes e bônus.
- Clique em Comprar adicional de envios. A janela mostra Sua reserva agora: N e os pacotes à venda lado a lado, cada um com o nome, a quantidade de envios, o preço, o preço a cada mil envios e a validade (ou Sem validade). O mais popular tem o selo Mais vendido.
- Escolha o pacote em Comprar. Você vai para uma página de pagamento segura e volta para a Postal ao concluir.
- De volta à Cobrança, o aviso diz Pagamento recebido. Os envios entram na sua reserva assim que o pagamento é confirmado (no cartão, na hora). Se você desistir, aparece Compra cancelada. Nenhum valor foi cobrado.
Cartão e Pix
- O pagamento é único, sem assinatura. O cartão de crédito sempre vale; o Pix aparece quando os preços dos pacotes estão em reais, e a janela diz Pague com cartão de crédito ou Pix.
- No cartão, os envios entram na reserva na hora. No Pix, entram quando o pagamento é confirmado, e a compra fica como Aguardando pagamento até lá. Um Pix que não é pago a tempo vira Pagamento não concluído, nada entra na reserva e nada é cobrado.
- O pacote é cobrado na moeda da cobrança do time, quando ele tem preço nela.
- A validade começa a contar quando o pagamento é confirmado.
- Só o dono e os admins compram.
O histórico das compras
Embaixo do cartão, Compras do adicional de envios lista os pacotes comprados e os bônus, com o que ainda resta de cada um. As colunas são Data, Pacote, Restam (N de M), Valor, Status, Validade e o link do recibo. O status é Aguardando pagamento, Ativo, Esgotado, Expirado, Pagamento não concluído, Reembolsado ou Cancelado. Os bônus concedidos pela Postal aparecem como Cortesia, no lugar do valor.
#Como a reserva é usada
A ordem de uso
- A cota mensal do plano é usada primeiro.
- Quando a cota acaba, entra a reserva, com um crédito por e-mail. Os créditos que vencem primeiro saem primeiro, e os que não têm validade ficam por último.
- Se a reserva acabar e o time ligou Continuar enviando acima do limite mensal (veja Cobrança), o envio segue e os e-mails extras são cobrados por mil. Só entram nessa conta os e-mails que a reserva não cobriu.
- Sem reserva e sem o envio além do limite, o envio é recusado com
429 monthly_quota_exceeded(no SMTP,452 4.5.3) até a cota renovar, no dia 1º (UTC).
O que gasta crédito
- Cada e-mail enviado pela API ou por SMTP depois do fim da cota mensal gasta um crédito. Um envio em lote usa os créditos de uma só vez; se a reserva não cobre o lote inteiro (e o envio além do limite está desligado), o lote é recusado inteiro, sem criar e-mails e sem gastar crédito.
- Um e-mail que falha ao ser criado não gasta crédito, e repetir o mesmo pedido com a mesma chave de idempotência gasta um só.
- Os e-mails para os endereços de teste não usam cota nem crédito.
- As campanhas não usam a reserva. Elas contam na cota mensal do plano e, se a cota acaba no meio do envio, a campanha fica pausada e continua sozinha quando a cota renova.
O limite diário continua valendo
A reserva estende só a cota mensal. Se o seu plano tem um limite diário de envios, ele continua valendo mesmo com a reserva cheia: ao atingi-lo, os envios recebem 429 daily_quota_exceeded até as 00:00 UTC, e a reserva espera. O cartão da Cobrança lembra: O limite diário de envios do plano continua valendo, mesmo com a reserva.
#Validade
Cada pacote tem a validade que lhe foi definida: uma quantidade de dias, contados da confirmação do pagamento, ou Sem validade. A janela de compra mostra a de cada pacote (Válidos por N dias após a compra ou Sem validade).
- Passada a validade, os envios que sobraram deixam de contar e o pacote passa a Expirado. O que já foi usado continua usado.
- Pacotes sem validade não vencem. Eles são usados depois dos que têm data.
- Na Cobrança, Próximo vencimento mostra a data do primeiro pacote a vencer, e cada pacote da lista diz N de M · vence em [data] ou N de M · Sem validade.
- Os pacotes que vencem antes são usados antes, para que sobrem os que duram mais.
#Estorno
Se o pagamento de um pacote é reembolsado, a Postal retira só os envios que ainda não foram usados daquela compra. O que já saiu da reserva continua usado. A compra passa a Reembolsado, sem envios restantes.
- Um Pix que não foi pago a tempo não entra na reserva (Pagamento não concluído).
- Um bônus retirado pela Postal aparece como Cancelado.
#Onde a reserva aparece
| Onde | O que mostra |
|---|---|
| Configurações › Cobrança | O cartão Adicional de envios: a Cota mensal do plano, a Reserva de envios (com Em uso: a cota do plano acabou e os envios saem da reserva. ou Entra em uso quando a cota mensal do plano acabar., N usados da reserva neste mês e o Próximo vencimento), os Pacotes e bônus e o histórico. |
| Configurações › Uso | Na parte de envio, a linha Adicional de envios mostra o saldo da reserva. Ela aparece quando o time tem, ou já usou, a reserva. Veja Uso. |
| Medidor de envios | Com a reserva em uso, o medidor do mês no menu da conta acrescenta Usando a reserva do adicional de envios: restam N. |
| E-mails de aviso | Aos 80% e aos 100% da cota mensal, o dono e os admins com os alertas de uso ligados recebem um e-mail. Com reserva, ele diz que os novos e-mails usam a reserva; sem reserva, e se o time pode comprar, lembra do Adicional de envios. |
| Recusa de envio | Sem cota e sem reserva, a API recusa com 429 monthly_quota_exceeded, e a mensagem diz onde comprar quando dá: Compre um Adicional de envios em Configurações › Cobrança, faça upgrade do plano ou espere a cota reiniciar no dia 1º (UTC). |
#Pela API
As rotas de compra usam a sessão do painel de um dono ou admin: uma chave de API recebe 403. Pela chave, dá para ler a reserva junto com a cota do mês.
| O quê | Onde |
|---|---|
| Ver a reserva, os pacotes à venda e as compras | GET /billing/email-credits. |
| Comprar um pacote | POST /billing/email-credits/checkout: devolve o endereço da página de pagamento. Ao voltar, o painel abre com ?extra_sends=success ou ?extra_sends=canceled. |
| A reserva ao lado da cota | O bloco emails.credits de GET /usage, com saldo, uso do mês, se está em uso e os pacotes, e o bloco email_credits de GET /billing. |
| O erro de cota | 429 monthly_quota_exceeded nos envios, quando a cota e a reserva acabaram. |
Veja também: Configurações › Cobrança · Cotas de envio · Adicional de envios (API).