Enviar por e-mail recibos e faturas pagas
Envie automaticamente recibos de pagamento ou reembolso.
With payments using Elements or direct API calls, you can manually or automatically send customized email receipts.
Recursos dos recibos
Cada recibo contém um link para visualização em um navegador e um número de recibo, que é útil para pesquisar dados de pagamento.
Você também pode acessar o link para ver o recibo em um navegador por meio da API no objeto Charge relacionado ao PaymentIntent. Quando você acessa o link, o recibo sempre mostra o status mais recente dessa cobrança; se ela foi reembolsada, o recibo mostra isso corretamente.
Como medida de segurança, os links de recibo expiram em 30 dias. Quando um link de recibo expira, o cliente precisa informar o endereço de e-mail original para receber um novo recibo nesse endereço.
Envie recibos automaticamente
To enable automated receipts, toggle Successful payments on in your Customer emails settings. Receipts are only sent when a successful payment has been made—no receipt is sent if the payment fails or is declined.
You don’t have to specify any receipt parameters when you create a PaymentIntent. However, if you specify a receipt_email and the payment succeeds, Stripe sends a receipt to that address regardless of your Customer emails settings.
The receipt displays the amount, your public business information, and any value in the description
parameter of the request. Receipts for one-time payments include only this information—additional line items can’t be added.
To trigger an automatic receipt after the payment is complete, update the PaymentIntent’s receipt_email.
Envie recibos manualmente
Para enviar recibos pelo Dashboard, clique em Enviar recibo na seção Histórico de recibos de uma página de detalhes do pagamento. Você também pode passar o cursor sobre um pagamento na seção Pagamentos da página de um cliente e clicar no ícone Enviar recibo. Para reenviar um recibo por e-mail, insira um endereço de e-mail diferente ou especifique uma lista de endereços separados por vírgulas para enviar o recibo a vários destinatários. Um registro dos últimos 10 recibos é exibido na página do pagamento.
Para conceder ao cliente acesso direto a um recibo no seu aplicativo, use o receipt_
.
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.
- Descrição dos bens ou serviços fornecidos.
- Código de autorização.
- Informações da 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.
Recibos de reembolso
Quando um pagamento é reembolsado, a Stripe pode enviar automaticamente um recibo para o mesmo endereço de e-mail informado na cobrança original. Você também pode usar o Dashboard para enviar manualmente uma cópia do recibo do reembolso. Para habilitar os recibos automáticos de reembolso, ative a opção Reembolsos em suas Configurações de e-mails para clientes.
Recibos de pagamento de faturas e assinaturas
A Stripe cria um recibo quando um cliente paga uma fatura ou faz pagamento de qualquer assinatura. Os recibos de pagamentos de assinaturas e faturas são discriminados para incluir itens de linha, descontos e impostos. Após o pagamento, a página da fatura hospedada inclui um link para um recibo que o cliente pode baixar para registro próprio.
Recibos do Stripe Connect
As configurações dos recibos dependem do tipo de cobrança e de conta:
Destination Charges e cobranças e transferências separadas: os rendimentos usam as configurações de E- mails do cliente, Marca e Dados públicos da conta da plataforma.
Direct Charges: os recibos usam as configurações E-mails aos clientes, Marca e Detalhes públicos da conta da plataforma.
As contas de plataforma podem enviar um recibo para uma conta conectada passando receipt_
ao fazer uma solicitação de cobrança.
Para contas conectadas que usam o Stripe Dashboard (o que inclui contas conectadas Standard), você pode definir as configurações de recibo em Marca. Para contas conectadas que não usam o Dashboard (o que inclui contas conectadas Express e Custom), a plataforma define as configurações de recibo usando setups.branding.
Enviar faturas pagas automaticamente
The Payment Intents API can’t generate invoices. Use Stripe Billing to directly create the invoice.
Localização
When using the Payment Intents API, the language of the receipt is determined by several factors:
- If a Customer is set, their preferred locale is used if available.
- If a Customer is set without any preferred locale, or if no Customer is set, the language setting from the Stripe Dashboard is applied.