With Alguna’s Stripe integration you will be able to:
  • Use Stripe in the native checkout provided by Alguna.
  • Automatically collect payments for recurring invoices.
  • Automatically 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

Using the email address of the service account you created earlier, grant the following permissions:
Production: https://app.alguna.io/settings/integrations
Sandbox: https://app.sandbox.alguna.io/settings/integrations
1

First Step

Once logged into the correct environment, go to General Settings → 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 may name 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 account has been created, Alguna uses Stripe ID as an external ID (alias) so any usage data sent to Alguna with that ID would automatically be assigned to the original account.

​
Collecing 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 collecing 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.

​
Recommented Stripe Settings

  • When using Alguna invoicing and Stripe payments, you should disable payment receipts processed by Stripe in Settings → Business → More → Customer emails to ensure successful payments.

​
Disconnect

Please send a request to [email protected] for any disconnections. This is to make sure that we can safely follow the disconnection process without any impact on your existing data.