Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.

Envía facturas con Stripe

Stripe
Autor: Stripe

Crea y envía facturas de marca para clientes con la plataforma de pagos de Stripe.

Cómo funciona esta extensión

Usa esta extensión a fin de crear y enviar facturas de marca para clientes mediante la plataforma de pagos Stripe.

Las facturas se personalizan automáticamente con el logotipo y el tema del color de tu negocio que estableciste en Stripe. Luego de enviar la factura, puedes usar el panel de Stripe para hacer un seguimiento del pago del cliente y de la cantidad de dinero que procesaste con los informes y gráficos detallados.

Esta extensión detecta tu colección de Cloud Firestore especificada para documentos nuevos (como el siguiente ejemplo). Cuando agregas un documento, Stripe usa la información de la factura de ese documento para crear una factura en su sistema; luego, envía esa factura a la dirección de correo electrónico especificada en el documento. De forma opcional puedes administrar tus direcciones de correo electrónico mediante los ID del usuario de Firebase Authentication.

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

Este es un ejemplo del aspecto de tu factura personalizada

Una página de factura en la que se muestra un recibo desglosado, con opciones de pago con tarjeta o transferencia bancaria

Una función opcional de esta extensión es actualizar automáticamente el estado de la factura en su documento de Cloud Firestore. Registra un webhook de Stripe que detecte eventos de factura de Stripe para configurar esta función luego de instalar la extensión. Si quieres usar esta función opcional, deja el parámetro "Secreto de webhook de Stripe" vacío durante la instalación; luego, vuelve a configurar la extensión instalada con el valor real de tu webhook registrado. Se proporcionan más detalles sobre este proceso luego de la instalación.

Configuración adicional

Antes de instalar esta extensión, configura los siguientes servicios de Firebase en tu proyecto:

  • Cloud Firestore para almacenar la información de las facturas y, opcionalmente, el estado de las facturas.
    • Sigue los pasos en la documentación para crear una base de datos de Cloud Firestore.
  • Firebase Authentication para administrar de forma opcional el correo electrónico y los datos del cliente.
    • Habilita los métodos de acceso que quieras ofrecer a tus usuarios en Firebase console.

También debes tener una cuenta de Stripe y una clave de API de Stripe antes de instalar esta extensión.

Nota: Stripe tiene un modo de prueba que te permite realizar llamadas a la API sin realizar pagos reales. Para usar esta extensión con el modo de prueba de Stripe, configura el parámetro "clave de API de Stripe" (durante la configuración de la extensión) para usar una clave de modo de prueba. La clave de modo de prueba es similar a rk_test_12345, mientras que una clave de modo en vivo sería rk_live_12345. Como esta extensión solo requiere acceso de escritura a tus recursos de "cliente" y "facturas" de Stripe, te recomendamos crear una clave restringida con acceso limitado a solo estos recursos, en lugar de usar tu clave secreta.

Facturación

Esta extensión usa los siguientes servicios de Firebase, que pueden tener cargos asociados:

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

Esta extensión también usa los siguientes servicios de terceros:

Eres el responsable de los costos asociados con el uso que le das a estos servicios.

Nota de Firebase

Para instalar esta extensión, tu proyecto de Firebase debe tener el plan Blaze (prepago). Solo se te cobrará por los recursos que utilices. La mayoría de los servicios de Firebase ofrecen un nivel gratuito para volúmenes pequeños. [Obtén más información sobre la facturación de Firebase].(https://firebase.google.com/pricing)

Desde el 17 de agosto de 2020, se te facturará un pequeño importe (habitualmente menos de $0.10) cuando instales o vuelvas a configurar esta extensión. Consulta las Preguntas frecuentes sobre la facturación de Cloud Functions para Firebase a fin de obtener una explicación detallada.

Cómo instalar esta extensión

Usa Firebase console

Puedes usar Firebase console para instalar y administrar las extensiones.

Instala con console

Usa Firebase CLI

También puedes usar Firebase CLI para instalar y administrar las extensiones.

Paso 1: Ejecuta el siguiente comando npm para instalar la CLI o actualizarla a la versión más reciente.

npm install -g firebase-tools
¿No funciona? Consulta la referencia de Firebase CLI o cambia tus permisos de npm.

Paso 2: Ejecuta el siguiente comando para instalar la extensión.

firebase ext:install stripe/firestore-stripe-invoices --project=projectId_or_alias
Admite
Authentication Cloud Firestore
Autor
En colaboración con
Licencia
Apache-2.0
Versión
0.1.6