Stripe
Stripe is a global card payment gateway commonly used with CMP for prepaid wallet top-ups and postpaid saved-card / auto-charge flows.
Provider: stripe.com
| Best for | Global card payments; postpaid auto-charge |
| Configure in CMP | Settings → Billing Setup → Payment Setting / Payment Provider |
| Payment modes | Prepaid top-up; Postpaid when autocharge is enabled |
What Stripe is used for in CMP
| Mode | Behaviour |
|---|---|
| Prepaid | Customer selects Stripe at wallet top-up / registration |
| Postpaid | Save card; auto-charge invoices when due (variable amounts) |
| Manual | Customer can save a card later — may convert Manual → Postpaid |
See Payment Gateways hub for Payment Setting / Payment Provider paths.
Payment Gateway Providers
Form title: Edit Payment Gateway Providers
Path: Settings → Billing Setup → Payment Provider (breadcrumb: Payment Gateway Providers)
Configure Stripe at the Payment Provider level first: currencies supported by the provider record, Has Autocharge, logos, and status. Then complete Configure Stripe (Payment Gateway Settings) for credentials and branch assignment.
Before adding a currency, refer to the payment gateway documentation for supported currencies and minimum/maximum transaction limits: Stripe supported currencies.
Currencies
Required. Select the currencies this provider record supports (for example, USD, INR). These are the currencies associated with Stripe at the Payment Provider level.
Has Autocharge
Yes / No. Enables postpaid auto-charge for Stripe in CMP. Set Yes when using Stripe for postpaid.
Enabling Has Autocharge only turns the feature on at the application layer. The payment gateway must also support autocharge natively.
Stripe supports automatic charging of saved credit cards for recurring payments with variable amounts. Postpaid auto-charge still requires Has Autocharge = Yes here.
If a provider does not support that capability natively, postpaid auto-charge will not work reliably even when Has Autocharge is set to Yes.
Upload Light Theme Logo
Optional. Logo shown for Stripe in the light theme UI. Use Browse a file to upload.
Upload Dark Theme Logo
Optional. Logo shown for Stripe in the dark theme UI. Use Browse a file to upload.
Status
Required. Active or Inactive. Set Active when Stripe should be available as a payment provider.
Configure Stripe
- Confirm Stripe is configured under Payment Gateway Providers — see above
- Obtain sandbox (then live) keys from the Stripe Dashboard
- Open Settings → Billing Setup → Payment Setting → add or edit Stripe
- Assign Branches, enter keys, and set the flags below
- Assign Stripe to each currency under Currencies → Configure → Step 2 — see Payment Gateways
Edit Payment Gateway Settings (Stripe)
Form title: Edit Payment Gateway Settings
Path: Settings → Billing Setup → Payment Setting → edit Stripe
Payment Provider
Required. Select Stripe.
Branches
Required. Assign Stripe to one or more branches (for example, Stack Console). The gateway is visible only for customers under those branches. See branch visibility.
API Key
Required. Stripe publishable / public key (for example, pk_test_… for sandbox or pk_live_… for production).
API Secret
Required for live charging. Stripe secret key (sk_test_… / sk_live_…) — keep confidential. Enter the value from the Stripe Dashboard; do not leave blank in production.
Note
Optional. Internal description (for example, Stripe Payment Gateway Setting).
Disable On Registration
Optional. If enabled, this gateway is hidden on the self-registration form. Admins can still use it while onboarding customers from the admin panel.
Is Live
Yes / No. Use No with sandbox / test credentials (pk_test_… / sk_test_…); set Yes only when using production keys.
Has Save Card
Yes / No. Whether customers can save a card for later charges. Set Yes for typical postpaid flows.
Is Default For Postpaid
Yes / No. Whether Stripe is the default gateway for postpaid / saved-card charging on that branch. Set Yes when Stripe is your postpaid gateway.
Currency limits (on the Stripe gateway form)
The Stripe edit form also includes a per-currency amount table. Before adding a currency, check Stripe’s supported currencies and limits: Stripe supported currencies.
These rows set min / max / auth amounts for Stripe. You must still attach Stripe to each currency under Currencies → Configure → Step 2 — see currency assignment.
| Column | Description |
|---|---|
| Currency | Currency code (for example, INR, USD) |
| Min. Amt. | Minimum transaction amount for this currency |
| Max. Amt. | Maximum transaction amount for this currency |
| Auth. Amt. | Authorization / hold amount used when validating a card (for example, a small amount such as 1) |
Example values (adjust to your business rules and Stripe limits):
| Currency | Min. Amt. | Max. Amt. | Auth. Amt. |
|---|---|---|---|
| INR | 1 | 100000 | 1 |
| USD | 1 | 100000 | 1 |
Status
Active / Inactive. Set Active when this Stripe configuration should be available for the assigned branches (subject to currency assignment).
Testing
- Use Stripe test mode keys before go-live (
Is Live= No) - Test prepaid top-up and (if postpaid is enabled) save-card + invoice auto-charge