Recibos por e-mail

Com pagamentos usando Elements e a API Payment Intents, você pode enviar recibos por e-mail personalizados de forma manual ou automática. 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_email 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.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=usd \
  -d "payment_method_types[]"=card \
  --data-urlencode description="Thanks for your purchase!" \
  --data-urlencode receipt_email="I.override.your.customer.email.settings@example.com"

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.

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.