NewMaxio Metering is now available — usage-based billing for Advanced Billing.Learn more
/

Configure the Stripe 1Way Integration

··

Last updated on Sep 20, 2026

The Stripe 1Way Integration is a plug-and-play integration, designed to work with minimal setup. Enter a few security and settings selections, and you're ready to start reporting on Revenue, cohorts, MRR, and more for your existing and future Stripe data.

Complete this after connecting your Maxio Platform account to Stripe. If your account isn't connected yet, follow Setup the Stripe 1Way Integration first.

From Stripe, Maxio Platform pulls Plans, Customers, and Invoices, and from those, builds Transactions and Revenue that you can use for financial and analytic reporting. Once your Stripe data is in Maxio Platform, you can optionally sync that data to QuickBooks. If you plan to do so, your settings here directly affect your ability to sync Stripe-created Customers and Invoices to QuickBooks.

Configure sync

Stripe 1Way Integration settings

SettingDescription
Test Mode(Maxio Support only) Syncs test data from your Stripe account into Maxio Platform instead of live data. Contact Maxio Support to enable or disable this for your account.
Set Customers to Not SyncCheck this box to prevent Stripe-created Customers and their Invoices from syncing into QuickBooks. This is the default setting.
Default RegisterSelect the Register into which all data from Stripe is placed, including Transactions and Invoices. All Stripe data resides in a single Register. If 100% of your Maxio Platform data comes from Stripe, you can use the default Register in your account, "Main."
If you plan to use the Stripe 1-Way Integration and also add Customers, Invoices, or other financial records into Maxio Platform directly, or through another integrated system such as Salesforce, set up a dedicated Register to hold your Stripe data and select that as your default.
Item Creation ModeChoose how to treat Items coming from Stripe.
  • Match Existing Item Names - Attempts to match your Stripe Plan names with the Items you already have in Maxio Platform. If the Plan name matches an existing Maxio Platform Item name, the Invoice in Maxio Platform is created using that existing Item and its settings.
  • Always Create Unique Items - Creates a new Item in Maxio Platform even if the Stripe Plan name matches an existing Maxio Platform Item. This is the default setting. Because a newly created Item defaults to not syncing, this option also ensures Invoices don't sync to QuickBooks until you set the new Item to sync.
Sync ScheduleChoose when Maxio Platform automatically syncs with Stripe.
  • Manual Sync Only - Requires you to click the Sync button to fetch data from Stripe. This is the default setting. Use this option when you first configure and test your Stripe integration.
  • Hourly Sync - Syncs automatically once per hour. Use this option if you're generating up to a few thousand Invoices per day.
  • Nightly Sync - Syncs automatically once per day, between 2 AM and 3 AM. Use this option if you're a high-volume Stripe customer generating more than 2,000 Invoices per day.
Sync Invoice StatusesChoose which Stripe Invoice statuses to accept: Open, Paid, Uncollectible, or Void.
The default selection is Open, Paid, and Uncollectible. Void is not included by default.
Sync Invoices From Stripe Only On or After DateSet to sync only Invoices with this date or later.
Sync Invoices From Stripe Only Through DateSet to sync only Invoices with this date or earlier.
Generate Transactions After SyncCheck this box if you want Transactions to be generated from the Stripe-created Invoices after they sync into Maxio Platform.
For a Transaction to be generated, the option must also be enabled for the Item in its Understand Items profile. If the Item is created in Maxio Platform from a synced-in Stripe Plan, all Item generation settings are set automatically. If you select Match Existing Item Names for your Item Creation Mode, make sure generation is turned on for your existing Items too.
Post-Process Generated Transactions in BulkCheck this box to perform post-processing on all unassociated Invoice Line Items as a single step instead of one at a time. Recommended for high-volume workflows. Transactions are generated for your Invoice Line Items in bulk, typically during the early morning when server traffic is low.
This post-processing generates Transactions for all unassociated Invoice Line Items, even those that don't originate from Stripe. If you typically build Transactions around Line Items synced in from the GL, or you have unassociated Invoice Line Items you want to process manually, don't enable this setting.
Non-Plan Item for InvoicesUse this Item for Invoice lines received from Stripe that aren't associated with a Plan. See Stripe 1Way Data Mapping for how the Non-Plan Item gets used when creating Transactions.
Discount TreatmentChoose how to treat discounts coming from a Stripe coupon.
  • Use Net Invoice Line Amounts - Bakes the coupon's discount directly into the amount of the Invoice Line it applies to, with no separate record of the coupon or the original, pre-discount amount. This is the default setting.
  • Create Discount Lines - Saves the discountable Invoice Line at its full, pre-discount amount, and adds a second, negative-amount Invoice Line Item for the discount, referencing the originating Stripe coupon. See Stripe 1Way Data Mapping for how coupons map to Invoice Lines under each setting.
Fallback Discount ItemRequired only when Discount Treatment is set to Create Discount Lines. Select the Item used for the discount Invoice Line created from a Stripe coupon. The sync halts with an error until this is set, if any synced Invoice has a coupon applied.

The Sync Schedule setting here only controls when a sync runs automatically. To control which individual sync steps actually run, and to review or reset a step's sync progress, see Understand Stripe 1Way Sync Steps.

Still need help?
Reach out and our support team will take it from here.

Contact support