Recibos por e-mail
Envie automaticamente recibos e faturas pagas.
Com pagamentos usando o Elements e a API Payment Intents, você pode enviar de forma manual ou automática recibos por e-mail personalizados. Saiba mais sobre recibos de pagamentos.
Envie recibos automaticamente
Para habilitar os recibos automáticos, ative a opção Pagamentos concluídos nas configurações de e-mails de clientes. Somente um pagamento bem-sucedido aciona um recibo. Pagamentos com falha ou recusados não enviam um recibo.
Opcionalmente, você pode especificar um receipt_email quando criar um PaymentIntent. Se fizer isso, a Stripe enviará um recibo para esse endereço em vez do endereço de e-mail do cliente.
Os endereços de e-mail receipt_
e do cliente são os únicos valores usados para enviar um recibo. Não enviamos recibos para um endereço de e-mail incluído no PaymentMethod billing_details de um pagamento.
O recibo exibe o valor, suas informações comerciais públicas e qualquer valor no parâmetro description
da solicitação. Os recibos de pagamentos avulsos incluem apenas essas informações. Não é possível adicionar itens de linha adicionais.
Para acionar um recibo automático após a finalização do pagamento, atualize o parâmetro receipt_email do PaymentIntent.
Personalizar recibos
Altere a aparência e a funcionalidade dos recibos com as seguintes opções de personalização:
- Marca: modifique o logotipo e as cores em suas configurações de marca. O tamanho máximo para um arquivo de imagem de logotipo personalizado é 512 KB. O logotipo ideal deve ser uma imagem quadrada com mais de 128 x 128 pixels. São aceitos arquivos JPG, PNG e GIF.
- Informações públicas: especifique as informações públicas que você deseja incluir, como número de contato ou endereço do site, nas configurações de dados públicos.
Para exibir texto personalizado, use o atributo description no PaymentIntent. Alguns exemplos incluem:
- Descrição das mercadorias ou dos serviços fornecidos
- Código de autorização
- Informações de assinatura
- Políticas de cancelamento
É possível ver uma prévia em tempo real do recibo por e-mail na página de configurações de marca no Dashboard . Para enviar um recibo de teste, passe o cursor sobre a imagem de visualização, clique em Enviar recibo de teste e insira seu endereço de e-mail.
Cuidado
Os recibos extraem dados do objeto Charge
gerado quando o PaymentIntent é confirmado. Para atualizar dados do recibo como a description
após a geração da cobrança, é preciso atualizar a cobrança. As alterações em um PaymentIntent confirmado não aparecem nos recibos.
Enviar automaticamente faturas pagas
A API Payment Intents não pode gerar faturas. Use o Stripe Billing para criar diretamente a fatura.
Localização
Quando você usa a API Payment Intents, o idioma do recibo é determinado por vários fatores:
- Se um cliente for definido, a localidade preferencial é usada, se disponível.
- Se um cliente for definido sem nenhuma localidade preferencial, ou se nenhum cliente for definido, a configuração de idioma do Stripe Dashboard será aplicada.