Simulation configurations
Create, view, and manage simulation configurations for your organization. A simulation configuration consists of plans you create that the Pismo platform uses to calculate payment options when you request a simulation. Each plan defines the installment options available to customers and how payment amounts are calculated, including the calculation method, interest rate, and fees.
With the simulation configurations feature, you can:
- Define and launch installment offers, such as card installment purchases and Buy Now, Pay Later (BNPL) plans.
- Set a default configuration for your organization, so that installment options are available for all of your programs.
- Tailor installment offers to specific programs, such as offering lower interest rates to a premium card program.
- Target plans at specific kinds of operations, merchants, or customer groups.
- Update installment options, interest rates, and fees as your business needs and market conditions change.
Supported actionsIn Control Center, you can create and manage simulation configurations and associate them with your organization and programs. Note the following differences from the API:
- You can't run simulations in Control Center. To request a simulation, use the Create simulation endpoint.
- You can only associate a simulation configuration with an individual account through the API. For more information, refer to Attach simulation config to account.
- In Control Center, a plan's minimum installment amount and first installment delay apply to all of the plan's installment options. Through the API, you can set different values for each number of installments. For more information, refer to Create simulation config.
For more information about simulations on the Pismo platform, refer to Simulation service.
From Control Center, you can do the following:
- View simulation configurations
- Create a simulation configuration
- Associate simulation configurations
- Manage simulation configurations
- Manage plans
View simulation configurations
To view the list of simulation configurations and explore a configuration and its plans in more detail, do the following:
-
From the main menu, select Configurations > Simulation configurations.
The Simulation configurations screen is displayed. You can find specific configurations using the search field.The Simulation configurations screen lists the simulation configurations for your organization. The banner shows the configuration associated with your organization. This organization-level configuration is the default for any program that doesn't have its own configuration. For more information, refer to Associate simulation configurations.
The ASSOCIATED WITH column shows where each configuration is used:
- Organization—The configuration is associated with your organization.
- Program—The configuration is associated with one or more programs.
- Not associated—The configuration isn't associated with your organization or any programs.
Note: A configuration can be associated with both your organization and one or more programs.
-
On the Simulation configurations screen, select a configuration.
The Simulation configuration details screen is displayed, divided into the following tabs:- Configuration details—Provides an overview of the configuration, including its name, ID, and a list of the configuration's plans.
- Association details—Displays the organization and lists the programs the configuration is associated with.
-
On the Configuration details tab, select a plan.
The Plan details screen is displayed, divided into the following tabs:- Plan details—Provides an overview of the plan, including its billing method, installment options, calculation method, interest rate, and fees.
- Optional configurations—Displays the plan's optional settings, such as the minimum installment amount and down payment method, and the filters applied to the plan.
Create a simulation configuration
Create a simulation configuration to define the installment offers you make available to your customers.
You might create a simulation configuration to:
- Launch a new installment offer, such as BNPL at checkout or installment purchases on a card program.
- Run a promotional campaign, such as interest-free installments during a seasonal sales event.
- Offer different installment terms to different programs.
- Prepare an updated set of plans before replacing your organization's default configuration.
When you create a simulation configuration, you also create its first plan. After you create the configuration, you can add more plans and configure each plan's optional settings and filters.
Associating new configurationsA new simulation configuration isn't used in simulations until you associate it with your organization or a program. For more information, refer to Associate simulation configurations.
To create a simulation configuration, do the following:
-
On the Simulation configurations screen, select Create simulation configuration.
-
On the Simulation configuration details screen, enter a name for the configuration, and select Next.
-
On the Plan screen, configure the plan details and installment options, and select Next.
Note: You can use plan IDs in simulation requests to request specific plans. Simulation responses also return the plan ID for each plan, so choose IDs that are meaningful to your integration. -
On the Calculations screen, configure how the plan calculates payment options, and select Next.
-
On the Review and create simulation configuration screen, review your simulation configuration details, and select Create.
Associate simulation configurations
Associate simulation configurations with your organization and programs to control which plans are used when a simulation is requested. A simulation configuration isn't used in simulations until you associate it.
In Control Center, you can associate a simulation configuration at the following levels:
- Organization—The default configuration for all programs that don't have their own configuration. Your organization can have only one associated configuration. You can replace the configuration with another one, but you can't remove it.
- Program—Overrides the organization-level configuration for the program. Each program can have only one associated configuration, but you can associate the same configuration with multiple programs.
Organization-level configurationIf your organization doesn't have an associated configuration, simulations fail for any program that doesn't have its own configuration. Associate a configuration with your organization to use it as the default.
From Control Center, you can do the following:
- Associate a configuration with your organization
- Associate a configuration with a program
- Remove a program association
Associate a configuration with your organization
Associate a configuration with your organization to set the default installment offers for all programs that don't have their own configuration.
Replacing the organization-level configurationIf your organization already has a configuration associated with it, associating another configuration with the organization replaces the current configuration. The change affects simulations for every program that doesn't have its own configuration.
To associate a configuration with your organization, do the following:
-
On the Simulation configurations screen, select a configuration.
-
On the Simulation configuration details screen, select Associate with organization, and confirm.
Associate a configuration with a program
Associate a configuration with a program to offer program-specific installment terms that override your organization's default configuration. You might associate a configuration with a program to:
- Offer different terms to different customer segments, such as lower interest rates for a premium card program.
- Run a promotion for specific programs only.
- Roll out a new configuration to selected programs before making it your organization's default.
Each program can have only one associated configuration. If you associate a program that's already associated with another configuration, the new configuration replaces the current one.
To associate a configuration with a program, do the following:
- On the Simulation configurations screen, select a configuration, and select the Association details tab.
- Select Associate with program.
- On the Associate configuration with program screen, select the programs you want to associate, and select Next.
Remove a program association
Remove a program association when a program no longer needs its own installment offers, such as at the end of a program-specific promotion. After you remove the association, simulations for the program use your organization-level configuration.
Note: You can associate the configuration with the program again later.
To remove a program association, do the following:
- On the Simulation configurations screen, select a configuration, and select the Association details tab.
- Select the trash icon for the program you want to remove and confirm.
Manage simulation configurations
From Control Center, you can do the following:
Edit a simulation configuration name
Edit a simulation configuration name to reflect a change in scope or naming convention, or to fix errors.
To edit a simulation configuration name, do the following:
- On the Simulation configurations screen, select a configuration, and select the edit icon next to the configuration name.
- Enter the new name and select Save.
Add a plan
Add plans to a simulation configuration to expand the installment offers available to your customers. Each plan has its own installment options, calculation method, interest rate, fees, optional settings, and filters.
You might add a plan to:
- Offer longer repayment terms for high-value purchases
- Define both card installment and BNPL plans in the same configuration
- Add a promotional plan for specific customer groups
To add a plan, do the following:
- On the Simulation configurations screen, select a configuration, and select Add plan.
- Configure the plan details and calculation settings, review your plan, and confirm.
After you add a plan, you can configure its optional settings and filters. For more information, refer to Manage plans.
Remove a plan
Remove a plan when it's no longer required, such as when a promotional campaign ends or when you replace the plan with a new one.
Removing plansWhen you remove a plan, it's permanently deleted from the configuration. If you need the plan again, you must create and add it again.
A simulation configuration must have at least one plan. To remove the only plan in a configuration, first add another plan.
To remove a plan, do the following:
- On the Simulation configurations screen, select a configuration.
- Select the trash icon for the plan you want to remove and confirm.
Manage plans
From Control Center, you can do the following:
Editing plans in useIf the simulation configuration is associated with your organization or a program, any plan changes you make will affect future simulation requests after you save your changes.
Edit plan details
Edit a plan to keep its installment offers aligned with your business needs.
You might edit a plan to:
- Adjust interest rates in response to changes in market rates or funding costs
- Change the installment options available to customers
- Correct a configuration error
To edit plan details, do the following:
- On the Simulation configurations screen, select a configuration, then select a plan.
- On the Plan details tab, select the edit icon for the setting you want to edit.
Note: Not all plan details are editable. You can edit any plan detail that displays the edit icon. - Update the setting and select Save.
Configure optional plan settings
Configure optional plan settings to fine-tune a plan's installment offers.
For example, you can:
- Set a minimum installment amount to avoid offering installments too small to be cost-effective
- Delay the first installment for a promotion
- Cap interest to meet regulatory requirements
- Reduce the amount financed by collecting a down payment
To configure optional plan settings, do the following:
- On the Simulation configurations screen, select a configuration, then select a plan.
- On the Plan details screen, select the Optional configurations tab.
- Select the edit icon for the setting you want to configure, configure the setting, and select Save.
Manage plan filters
Apply filters to a plan to limit it to specific processing codes, merchants, or groups. When a simulation request includes a custom group filter, the Pismo platform uses the plans with at least one matching group. Otherwise, it matches the request's processing codes and merchants against the plan filters. If the request specifies plan IDs, the platform uses only those plans and does not apply filters.
You might apply filters to:
- Offer a plan only for the processing codes you list, such as purchases.
- Run a promotional plan at specific merchants, such as a retail partner.
- Offer exclusive plans to specific customer segments or sales channels, such as students or online purchases.
You can apply the following filter types to a plan:
- Processing codes—Limits the plan to transactions with specific processing codes. You select processing codes from the list of processing codes configured for your organization. For more information, refer to Processing codes.
- Merchants—Limits the plan to merchants with specific MCCs. An MCC classifies a merchant by the type of goods or services it provides, for example, 5411 for grocery stores.
- Groups—Limits the plan to simulation requests that include specific groups. A group is a custom label, such as "students" or "region-north", that you define and include in your simulation requests.
To add a filter, do the following:
- On the Simulation configurations screen, select a configuration, then select a plan.
- On the Plan details screen, select the Optional configurations tab.
- In the Filters section, select Processing codes, Merchants, or Groups.
- Select the add button for the filter type you want to add, configure your filters, and select Add.
To remove a filter, do the following:
- On the Simulation configurations screen, select a configuration, then select a plan.
- On the Plan details screen, select the Optional configurations tab.
- In the Filters section, select Processing codes, Merchants, or Groups.
- Select the trash icon for the filter you want to remove, and confirm.
Note: You can add the filter again later.
Updated about 19 hours ago