Integrar con la API Invoicing

Usa nuestras bibliotecas oficiales para acceder a la API de Stripe:

# Available as a gem
sudo gem install stripe

# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Para crear un producto, ingresa su nombre:

curl https://api.stripe.com/v1/products \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d name="Gold Special"

Precios define cuánto cobrar por los productos y con qué frecuencia. Esto incluye cuánto cuesta el producto, qué moneda usar y el intervalo de facturación (cuando el precio es de una suscripción). Al igual que sucede con los productos, si tienes pocos precios, es preferible gestionarlos en el Dashboard. Usa el importe unitario para expresar los precios en la unidad más baja de la moneda, en este caso, centavos (USD 10 son 1,000 centavos, por lo que el importe unitario es 1000).

Para crear el precio y asignarlo al producto, especifica el ID de producto, el importe unitario y la moneda. En el siguiente ejemplo, el precio del producto “Gold Special“ es de USD 10:

curl https://api.stripe.com/v1/prices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d product=
{{PRODUCT_ID}} \
  -d unit_amount=1000 \
  -d currency=usd

El objeto Customer representa al cliente que compra el producto y es necesario para generar la factura. Para crear un cliente con name, email y description, agrega el siguiente código y reemplaza los valores por los que correspondan:

curl https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d name="Jenny Rosen" \
  --data-urlencode email="jenny.rosen@example.com" \
  -d description="My first customer"

Después de crear el cliente, guarda su id en tu base de datos para poder usarlo después. En el próximo paso, por ejemplo, el ID del cliente se utiliza para crear una factura.

Establece el atributo collection_method en send_invoice. Para que Stripe marque una factura como vencida, debes agregar el parámetro days_until_due. Cuando envías una factura, Stripe se la envía al cliente por correo electrónico junto con las instrucciones de pago.

curl https://api.stripe.com/v1/invoices \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d collection_method=send_invoice \
  -d days_until_due=30

A continuación, debes crear un ítem de factura indicando el id del cliente, el price del producto y la invoice del ID de la factura.

La cantidad máxima de ítems de factura es 250.

curl https://api.stripe.com/v1/invoiceitems \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "pricing[price]"=
{{PRICE_ID}} \
  -d invoice=
{{INVOICE_ID}}

Si estableces auto_advance en false, puedes seguir modificando la factura hasta su finalización. Para finalizar una factura en borrador, usa el Dashboard, envíasela al cliente o págala. También puedes utilizar la API Finalize:

curl -X POST https://api.stripe.com/v1/invoices/
{{INVOICE_ID}}
/finalize \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Stripe envía un evento invoice.paid cuando se completa el pago de una factura. Escucha este evento para garantizar un cumplimiento confiable. Si su integración se basa solo en una devolución de llamada del lado del cliente, el cliente podría perder la conexión antes de que se ejecute la devolución de llamada, lo que provocaría que se le cobre al cliente sin notificar a tu servidor. Si configuras tu integración para escuchar eventos asincrónicos, también podrás aceptar diferentes tipos de métodos de pago con una sola integración.

Utiliza la herramienta webhook del Dashboard o sigue el inicio rápido del webhook para recibir estos eventos y ejecutar acciones como, por ejemplo, enviar un correo electrónico de confirmación del pedido a tu cliente, registrar la venta en una base de datos o iniciar un flujo de envío.

Además de administrar el evento invoice.paid, recomendamos administrar otros dos eventos si se cobran pagos con el Payment Element: