Skip to main content
The Stripe integration makes Stripe the payment processor behind Alguna: cards entered at checkout or in the customer portal are vaulted with Stripe, recurring and one-off invoices are charged to them automatically, and Alguna marks invoices paid and sends receipts when the charge succeeds. Use it when you want Alguna to run invoicing and collections and Stripe to move the money. Stripe can also calculate tax (Stripe Tax) or, separately, act as the invoicing system (Stripe Invoicing). Payments and their statuses are described in How Alguna works. With the integration you can:
  • Offer card payment in hosted and embedded checkout.
  • Collect recurring invoice payments automatically from the stored payment method.
  • Mark invoices as paid and send receipts from Alguna once the payment is collected.

​
Pre-requisites

You have an active Stripe account and admin rights to connect to Alguna. We also recommend connecting your Stripe account in your Sandbox before connecting to production.

​
Setup Stripe

Production: https://app.alguna.io/settings/connections/integrations
Sandbox: https://app.sandbox.alguna.io/settings/connections/integrations
1

First Step

Once logged into the correct environment, go to Settings → Connections → Integrations.
2

Second Step

On the Integrations Page → Click Connect on Stripe integration. A modal will pop-up asking you to allow access into your Stripe instance.
3

Third Step

Once connected, you can name the integration.
4

Fourth Step

On the next screen, choose to use Alguna as the source of creating new accounts in Stripe (this setting only applies to Alguna → Stripe).
5

Fifth Step

  • On the next screen choose to not import existing customers in Alguna.
  • For testing purposes, this is to avoid having third party.
  • This can always be triggered on an ad-hoc basis if you need it in the future by notifying Alguna in our shared Slack channel.
6

Sixth Step (optional)

  • Alguna can automatically migrate customer accounts, customer payment methods and customer subscriptions with no additional effort on your end.

​
Customer Creation

When a customer is created via Alguna, we automatically create an account in the Stripe instance if you choose to use Alguna as the source of truth for new accounts.
  • If created via external self-sign up - the process will match automatically.
  • If created via Alguna dashboard (new account) - you will need to add additional information via Account → Profile Page (billing information, contact details).
  • Any changes in Account should be reflected in Stripe within minutes.

​
Usage data and Stripe ID

As soon as a Stripe customer has been created, Alguna links it to the Alguna customer as a connected account, so usage sent to POST /events with the Stripe customer ID as account is assigned to the right customer, and Look up a customer ID by alias resolves a Stripe ID (cus_…) to the Alguna customer. Connected accounts can be read and managed with List connected accounts for a customer and Link a connected account to a customer.

​
Collecting Payments via Stripe

After setting up the Stripe integration, you can designate Stripe as your primary payment gateway for processing credit and debit card transactions.

​
Payment Collection Flows

  • When using self-sign up checkout, Alguna will use Stripe as a payment processor based on the customer input.
  • When collecting billing information from a customer and saving their default payment method.
  • In recurring and one-off payment invoices.

​
Unsuccessful Payments and Retries

When an automatic payment fails:
  1. Alguna sends a payment failure notification to the customer.
  2. Alguna retries the payment based on the agreed failed payment recovery (e.g. 1 / 3 / 5 days).
  3. Depending on the failed reason, Alguna will send an update payment method request email.
  4. If none of the above work, Alguna will send a direct link to the unpaid invoice.
The retry and reminder schedule is configured in Collections and Dunning, and can be extended with automations on the payment_failed trigger. Every attempt raises payment.created / payment.updated webhooks.
  • When using Alguna invoicing and Stripe payments, disable the payment receipts Stripe sends itself (in the Stripe dashboard under Settings → Business → Customer emails) so customers receive one receipt, from Alguna.

​
Disconnect

Please send a request to support@alguna.io for any disconnections. This is to make sure that we can safely follow the disconnection process without any impact on your existing data.