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

Envie faturas usando a Stripe

Stripe
Made by 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 Stripe webhook secret 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).

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 Stripe API key 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 customers e invoices 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:

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á pelos recursos utilizados. A maioria dos serviços do Firebase tem um nível sem custos 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: configurar um novo diretório do projeto no Firebase ou acessar um já configurado

Etapa 3: adicionar esta extensão ao seu manifesto de extensões ao ser executada

firebase ext:install stripe/firestore-stripe-invoices --local --project=projectId_or_alias

Etapa 4 (opcional): testar a extensão localmente usando o Pacote de emuladores do Firebase

firebase emulators:start

Etapa 5: implantar as extensões do seu manifesto ao projeto

firebase deploy --only extensions --project=projectId_or_alias
Compatível com
Authentication Cloud Firestore
Autor
Em colaboração com
Licença
Apache-2.0
Versão
0.2.0