Everything you need to know about the Stripe “Installment Payment Plans” app — from how installment plans work in Stripe to personalising plans for different customers and advanced billing scenarios.
There is no manual registration or login required. Simply install the app from the Stripe Marketplace and open it inside your Stripe Dashboard. Your account is created automatically using your Stripe account details — your Stripe Account ID, name, email, and company name are used to set everything up instantly. Click “Visit WebApp” from inside the app and you will be logged in automatically every time. You cannot access the WebApp directly from a browser without going through the Stripe Dashboard first.
Before creating installment plans, you need: (1) Your customers already created in Stripe — use the Stripe Bulk Customer Importer and Uploader app if you need to create them in bulk. (2) For charge_automatically, saved payment methods attached to each customer. That is all — the app creates the Product, Price, and Subscription at runtime for each row. No pre-existing Price IDs are needed.
The app automatically computes Per_Payment_Amount = round(Total_Amount ÷ Number_of_Installments, 2) for each row. You enter only the total and the count — the per-payment amount is calculated and saved to the database by the WebApp during file upload, and then used by the Stripe app to create the recurring price. You never enter Per_Payment_Amount in the file.
The app computes a cancel_at Unix timestamp for every row — calculated as: billing_start + (interval_seconds × interval_count × number_of_installments). This value is passed to Stripe when the subscription is created. Stripe automatically cancels the subscription when this timestamp is reached — after the final installment is paid. You never need to manually cancel installment plan subscriptions. If trial days are set, the billing start is offset accordingly so the plan still runs for the full number of installments after the trial ends.
Yes — for each row the app creates a dedicated Stripe Product named “Installment Payment Plan for — customer@email.com” and a corresponding recurring Price with the computed per-payment amount, currency, and billing interval. This approach means no pre-existing Price IDs are needed — any total amount, currency, and billing interval combination works without any prior Stripe setup. Each plan gets a clean, independent product and price in your Stripe account.
The app uses round(Total_Amount ÷ Number_of_Installments, 2) — so the result is rounded to 2 decimal places. For example: 1000 ÷ 3 = 333.33. Each installment charges 333.33. The total collected will be 333.33 × 3 = 999.99 — one cent short of the original total due to rounding. This is standard rounding behaviour. If exact total collection is critical, choose a Total_Amount and Number_of_Installments combination that divides evenly.
This is a Stripe platform restriction. Stripe locks a customer to a single currency the moment they have any active subscription, subscription schedule, invoice item, or discount. Once locked, every future plan created for that customer must use the same currency. If a customer already has USD activity in Stripe and you attempt to create a GBP installment plan for them, Stripe will return an error: “You cannot combine currencies on a single customer.” Always verify the customer’s existing currency in Stripe before importing. This restriction cannot be bypassed.
Six preset billing intervals are supported: daily, weekly, monthly, every_3_months, every_6_months, and yearly. Additionally, a custom option is available — when selected, you also fill in Custom_Billing_Period (day, week, month, or year) and Custom_Billing_Count (any positive integer). For example: custom + month + 2 = every 2 months. custom + week + 3 = every 3 weeks. This gives you full flexibility for any billing frequency Stripe supports.
Maximum installments depend on the billing interval to keep plan durations practical: daily — up to 365 (1 year). weekly — up to 104 (2 years). monthly — up to 120 (10 years). every_3_months — up to 40 (10 years). every_6_months — up to 20 (10 years). yearly — up to 12. For custom intervals, the cap is based on the Custom_Billing_Period type — same maximums as above per period. The minimum for all intervals is 2 installments.
charge_automatically — Stripe automatically charges the customer’s saved payment method on each installment billing date. No invoice email is sent to the customer. Requires a Payment_Method_ID in the CSV. The payment method is set as default at the subscription level only — the customer’s other saved payment methods are not affected.
send_invoice — Stripe creates an invoice and emails it to the customer on each billing date. The customer pays manually via the invoice link. You set Days_Until_Due (defaults to 30 if left empty). Leave Payment_Method_ID empty. Note: invoice emails are not delivered in Stripe test mode.
No. The payment method is set as the default at the subscription level only — meaning it is used exclusively for this installment plan. The customer’s account-level default payment method in Stripe is never changed. This is intentional — changing the customer default could silently affect other subscriptions the customer has. If you later need to change the payment method for the installment plan, update it at the subscription level in your Stripe Dashboard.
Failed rows are logged in the WebApp with the exact error message returned by Stripe — so you know precisely what went wrong for each row. The import continues processing all remaining rows — one failure does not stop the entire batch. You can review all failed records in the WebApp, download an error file with the original CSV format pre-filled, fix the underlying issue, and re-upload just the failed rows as a new file.
The app is designed to handle interruptions safely. When you re-open the Stripe app after a disconnection, you do not need to re-upload your file. Simply click the fetch button in the Stripe app to reload your existing file data, and then start the import again. The app automatically resumes from where it stopped — rows that were already successfully processed are skipped. Idempotency keys ensure that no product, price, or subscription is ever created twice.
There is no hard technical limit on file size. The app processes rows in batches with real-time progress tracking, so large imports of hundreds or thousands of installment plans are handled reliably without timeouts or browser memory issues.
Coupons apply automatically to every installment invoice generated during the subscription lifetime. The discount behaviour depends on the coupon’s duration setting in your Stripe Dashboard: once — applies to the first installment invoice only. repeating — applies for a set number of billing cycles. forever — applies to every installment invoice for the full plan lifetime. Important: the discount reduces the charged per-payment amount — it does not reduce the Total_Amount field in your CSV or the plan’s records.
Yes — full tax support is included. You can enable Stripe Tax automatic calculation per row (requires Stripe Tax to be configured in your Dashboard first). Alternatively, apply manual Tax Rate IDs (txr_) for fixed rates — both cannot be used together and validation catches this. For B2B invoicing compliance, you can display your business tax registration number (Account_Tax_Ids) and your customer’s own VAT/GST/ABN/EIN (Customer_Tax_IDs) directly on installment invoice PDFs — supporting compliance across any country.
Invoice Memo — free-text note shown on every installment invoice PDF and email your customer receives each cycle. Good for plan references, payment number tracking, or thank-you messages.
Custom Fields — structured key:value pairs shown in a table on every installment invoice PDF. Visible to customers. Use for PO numbers, project codes, contract references. Maximum 4 fields per invoice.
Metadata — internal key:value data attached to the subscription in Stripe. Never visible to customers. Only visible to you in the Stripe Dashboard and API. Additionally, installment plan fields (Total_Amount, Number_of_Installments, Per_Payment_Amount, Billing_Interval, Billing_Currency) are automatically merged into metadata by the app on every row — so the plan structure is always visible in your Stripe Dashboard.
Yes — every row in your file is completely independent. One customer can have a monthly plan with a $50 setup fee and charge_automatically, while the next can have a quarterly plan with send_invoice and 30 days to pay. Different totals, different installment counts, different currencies, different billing intervals, different trial days, different tax rates, different discounts — all fully per-customer, all from a single file upload. There is no requirement for any field to be consistent across rows.
You can reach our support team directly from the Stripe app dashboard and WebApp. You can also visit our Contact Support page or email us at support@asrrcrm.com. We aim to respond to all support requests within 48 hours. For faster resolution, please include your Stripe Account ID and a description of the issue.
We take bug reports seriously and fix issues as quickly as possible. Visit our Bug Report page or email us at support@asrrcrm.com. Please include as much detail as possible — what you were doing, what you expected, what actually happened, and any error messages. Screenshots or a copy of your file (with sensitive data removed) are very helpful.
Absolutely — we love hearing from our users and feature suggestions directly shape our roadmap. Visit our Contact Support page or email us at support@asrrcrm.com with your suggestion. Describe what you would like to see and how it would help your workflow. Popular and frequently requested features are prioritised for upcoming releases. Every suggestion is read and considered by our team.
We would love to hear about your experience. Submit your review on our Submit a Review page or email us at support@asrrcrm.com. Your honest feedback helps other businesses discover and trust the app. If something did not go as expected, please reach out to our support team first — we would love the opportunity to make it right before you leave your feedback.
Stripe Installment Payment Plans app lets you create flexible, customisable, and personalised installment payment plans to offer your customers — directly from your Stripe Dashboard using CSV, Excel, and Google Sheets. No APIs. No scripts. No manual work.
