Payment Provider Stripe

Connect Stripe to instellix to charge customers and process settlement data for accounting and payment assignment.

This article covers the Stripe setup in the instellix webportal. For automatic retries after failed charges, see Payment Retry Configuration.

Requirements

A Stripe account (test and/or live)
A Stripe secret API key for the environment you want to connect
Permission to configure Integration > Payment Providers in instellix
A Merchant Payment Account and Merchant Payment Gateway for Stripe

Setup overview

Step	Where	Purpose
1	Stripe + instellix	API credentials (Base URL + secret key) and activate the provider
2	instellix	Merchant Payment Account + Gateway
3	instellix	Customer Payment Accounts (tokenized payment methods)
4	instellix	Retry Strategy (optional)

1. Stripe credentials in instellix

Go to: Integration > Payment Providers > Stripe

Enter the Base URL for the Stripe API (typically https://api.stripe.com/).
Enter the Stripe secret API key (Merchant Key) for the environment (test or live).
Activate the Stripe provider when you are ready to process payments.
Default: deactivated.
Save.

2. Merchant Payment Account and Gateway

Create a Merchant Payment Account with payment provider Stripe:
Configuration > Payment > Merchant Payment Account
Create a Merchant Payment Gateway and attach that account (per currency as needed):
Configuration > Payment > Merchant Payment Gateways

Learn more: Merchant Payment Accounts · Merchant Payment Gateways

3. Customer Payment Accounts (CPA)

For charging, each customer needs a Customer Payment Account that references the Stripe Customer and the stored PaymentMethod.

Typical mapping:

instellix CPA field	Stripe value
Payment provider reference	Stripe Customer ID (`cus_…`)
Payment method reference	Stripe PaymentMethod ID (`pm_…`)

Also select the Stripe Merchant Payment Gateway on the CPA.

The payment method must be attached to the Stripe Customer (for example via SetupIntent / Elements). See Stripe: Save a customer’s payment method.

Learn more: Customer Payment Accounts

4. Retry Strategy

Under Integration > Payment Providers > Stripe, configure the Retry Strategy for recoverable failed charges (Retry Type, Retry Value, Max Retry Attempts).

See Payment Retry Configuration — including the Day-of-month rule.

Status polling (Stripe-specific)

If a payment intent remains in status SUBMITTED, instellix periodically asks Stripe for an updated status (polling, every 4 hours).

This is independent of the Retry Strategy (retries apply after a failed recoverable charge; polling covers delayed / still-open Stripe responses).

Settlements

Once Stripe is configured and activated with a valid secret API key, instellix automatically retrieves Stripe balance transactions and creates settlement reports and settlement items (for example daily reports named STRIPE-YYYY-MM-DD).

No separate report user or report activation in the Stripe Dashboard is required for this import.

Settlements are then available for payment assignment and accounting in instellix.