O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Envie faturas usando a Stripe

Stripe
Feito pela Stripe

Cria e envia faturas de clientes personalizáveis usando a plataforma de pagamentos Stripe.

Como esta extensão funciona

Use essa extensão para criar e enviar faturas de clientes personalizadas usando a plataforma de pagamentos Stripe.

As faturas são personalizadas automaticamente com o logotipo e a cor da sua empresa, que são definidos na Stripe. Após o envio da fatura, use os gráficos e relatórios detalhados no painel da Stripe para conferir se o cliente efetuou o pagamento e a quantia processada.

Esta extensão detecta novos documentos (como o exemplo abaixo) no conjunto especificado do Cloud Firestore. Quando você adiciona um documento, a Stripe usa as informações contidas nele para criar uma fatura no sistema. Depois, a fatura é enviada para o endereço de e-mail especificado no documento. Se quiser, gerencie os endereços de e-mail do cliente com os IDs de usuários do Firebase Authentication.

email: "customer@example.com",
items: [{
    amount: 2000,
    currency: "usd",
    quantity: 2, // Optional, defaults to 1.
    description: "Growth plan"
}]

Veja a seguir o exemplo de uma fatura personalizada.

Uma página da fatura que mostra um recibo detalhado, com opções de pagamento em cartão ou transferência bancária

A extensão oferece um recurso opcional para atualizar automaticamente o status da fatura no próprio documento do Cloud Firestore. É possível configurar esse recurso depois da instalação da extensão. Basta registrar um webhook da Stripe que detecta eventos de fatura (em inglês). Para usar o recurso opcional, deixe o parâmetro "Secret do webhook da Stripe" vazio durante a instalação. Depois, reconfigure a extensão instalada com o valor real do webhook registrado. Você verá mais detalhes sobre o processo após a instalação.

Outras configurações

Antes de instalar a extensão, configure os serviços a seguir no projeto do Firebase:

Cloud Firestore para armazenar as informações da fatura e o status dela (opcional). – Siga as etapas [incluídas na documentação] (https://firebase.google.com/docs/firestore/quickstart#create) para criar um banco de dados do Cloud Firestore. – Firebase Authentication para gerenciar os dados do cliente e e-mail (opcional). – No Console do Firebase, ative os métodos de login que os usuários poderão utilizar.

Também é necessário ter uma conta e uma chave de API da Stripe para instalar a extensão.

Observação: a Stripe oferece um modo de teste para você fazer chamadas de API sem precisar efetuar pagamentos reais. Para usar a extensão no modo de teste, defina o parâmetro "Chave de API da Stripe" durante a configuração da extensão para usar uma chave do modo de teste. Ela tem o formato "rk_test_12345" enquanto a chave de modo ativo é assim: "rk_live_12345". Como esta extensão só exige o acesso de gravação aos recursos "faturas" e "clientes" da Stripe, recomendamos a criação de uma chave restrita (em inglês). Ela tem acesso limitado somente a esses recursos, em vez de usar uma chave de secret.

Faturamento

Esta extensão usa os serviços do Firebase a seguir, que podem gerar cobranças:

– Cloud Firestore – Cloud Functions – Firebase Authentication (opcional)

A extensão também usa estes serviços de terceiros:

– Stripe Billing (informações sobre preços)

Você é responsável pelos custos associados ao uso desses serviços.

Observação do Firebase

Para instalar esta extensão, seu projeto do Firebase precisa estar no plano Blaze, com pagamento por utilização. Você só pagará os recursos utilizados. A maioria dos serviços do Firebase tem um nível gratuito voltado para pouco volume de uso. Saiba mais sobre o faturamento do Firebase.

Desde 17 de agosto de 2020, cobramos um pequeno valor (geralmente menos de US$ 0,10) quando você instala ou reconfigura esta extensão. Consulte as perguntas frequentes sobre o faturamento do Firebase relacionadas ao Cloud Functions para ver uma explicação detalhada.

Como instalar a extensão

Como usar o Console do Firebase

Para instalar e gerenciar extensões, use o Console do Firebase.

Instalar usando o console

Como usar a Firebase CLI

Para instalar e gerenciar extensões, também é possível usar a Firebase CLI:

Etapa 1: execute o comando npm (em inglês) a seguir para instalar a CLI ou atualizá-la para a versão mais recente.

npm install -g firebase-tools
Não está funcionando? Consulte a referência da Firebase CLI ou altere suas permissões do npm (em inglês).

Etapa 2: execute o comando a seguir para instalar a extensão.

firebase ext:install stripe/firestore-stripe-invoices --project=projectId_or_alias
Compatível com
Authentication Cloud Firestore
Autor
Em colaboração com
Licença
Apache-2.0
Versão
0.1.6