Integrar com a API Invoicing

Use nossas bibliotecas oficiais para acessar a API Stripe:

# Available as a gem
sudo gem install stripe

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

Para criar um produto, informe o nome dele:

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

Preços definem quanto e com que frequência cobrar os produtos. Você define o custo do produto, a moeda a ser usada e o intervalo de cobrança (quando o preço refere-se a uma assinatura). Assim como os produtos, se você tem poucos preços, é preferível gerenciá-los no Dashboard. Use o valor unitário para expressar preços na menor unidade da moeda, neste caso, centavos (10 USD são 1.000 centavos, portanto, o valor unitário é 1000).

Para criar um preço e atribuí-lo ao produto, passe o ID, o valor unitário e a moeda do produto. Neste exemplo, o preço do produto “Gold Special” é US$ 10:

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

O objeto Customer representa o cliente que compra seu produto e é obrigatório para criar uma fatura. Para criar um cliente com name, email e description, adicione este código, substituindo os valores pelos seus próprios valores:

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"

Após criar o cliente, armazene o id do cliente no seu banco de dados para usá-lo mais tarde. A próxima etapa, por exemplo, usa o ID do cliente para criar uma fatura.

Defina o atributo collection_method como send_invoice. Para a Stripe marcar uma fatura como vencida, é preciso adicionar o parâmetro days_until_due. Quando você envia uma fatura, a Stripe envia ao cliente um e-mail com instruções de pagamento.

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

Em seguida, crie um item de fatura passando um id de cliente, um price de produto e um ID de fatura invoice. Adicione itens de fatura a um único cliente por vez para evitar adicioná-los ao cliente errado.

O número máximo de itens da fatura é 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}}

Se você definir auto_advance como false, continue a modificar a fatura até finalizá-la. Para finalizar uma fatura provisória, use o Dashboard para pagá-la ou enviá-la ao cliente. Também é possível usar a API Finalize:

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

A Stripe envia um evento invoice.paid quando o pagamento de uma fatura é concluído. Ouça este evento para garantir um execução confiável. Se a sua integração depender apenas de um retorno de chamada no lado do cliente, o cliente poderá perder a conexão antes que o retorno de chamada seja executado, o que faria com que o cliente fosse cobrado sem que seu servidor fosse notificado. Configurar a integração para ouvir eventos assíncronos também permite aceitar diferentes formas de pagamento com uma única integração.

Use a ferramenta de webhook do Dashboard ou siga o início rápido do webhook para receber esses eventos e executar ações, como enviar um e-mail de confirmação do pedido ao cliente, registrar a venda em um banco de dados ou iniciar um fluxo de trabalho de envio.

Além de gerenciar o evento invoice.paid, recomendamos gerenciar dois outros eventos ao coletar pagamentos com o Payment Element: