Balance configurations in Control Center

Use Control Center to create balance configurations, which are a flexible set of rules that define how account balances and limits are impacted based on transaction activity. You can create them to manage account balances for your card and banking transactions.

For example, if you’re a bank, you can give a customer two separate credit limits for the same account:

  • A primary limit for everyday purchases
  • A secondary limit specifically for purchases made in multiple installments

For more information and examples, refer to Balance configurations overview.

📘

You can create and view balance configurations at the program level only, which apply to all accounts in the program. To create and view balance configurations at the organization, program, or specific account level, use the appropriate endpoint in the Balance configuration API.

From Control Center, you can do the following:

View the list of balance configurations

To view the list of balance configurations at the program level:

  1. From the main menu, select Configurations > Balance configurations.
  2. On the Balance configurations screen, select a balance configuration to review its details. You can find a specific balance configuration by using the Filter field. Filter on the program name or balance configuration ID.

Create a balance configuration

To create a balance configuration at the program level:

  1. From the main menu, select Configurations > Balance configurations.
  2. On the Balance configurations screen, select Create configuration.
  3. On the Program screen, select the program to associate with this balance configuration. You can select only one program. Select Next.
  4. On the Scenario screen, do the following:
    1. Enter a name for the scenario.
    2. Set whether to create the balance configuration as active (activated when created) or inactive (created but not activated).
    3. Select Next.
  5. Create filters, which are the rules used in scenarios. Refer to the following table for descriptions of each filter. You can also find this information in Control Center.
FilterDescriptionExamplesRequiredSpecial instructions
Processing codesSpecify transaction typesPurchases
Withdrawals
Yes, you must select at least one processing code.You can add multiple process codes and even select all.
Merchant Category Codes (MCCs)Categorize businesses by their goods and servicesMCC 5411 is the code for grocery stores.

MCC 5812 is the code for restaurants.
NoYou can add multiple MCCs.
InstallmentsIndicate that a total purchase is split into smaller, manageable paymentsA credit card payment is split into three installments.NoSet both minimum and maximum installments or leave both blank. The maximum number of installments allowed is 99.
Currency codesSpecify the three-letter identifier for currenciesBRL is the code for the Brazilian real.

USD is the code for the U.S. dollar.
NoYou can add just one currency code.
  1. Review the filters you created in the Filters created field, then select Next.
  2. On the Conditions screen, define the criteria for evaluating scenarios.

    Note that when you create a balance configuration, you define just one condition initially, which is known as the default. This is important because the Pismo platform checks conditions in the priority order you set. If the first condition matches, the search stops there, and the platform uses this condition. If not, the search continues until there is a match. If no conditions match, the platform denies the transaction.

    If you create other conditions, known as custom conditions, they are higher in priority than the default condition. The default condition is always the lowest in the priority order, meaning that it’s always checked last.

    You can reorder, edit, and delete custom conditions, but you can’t reorder, edit, or delete the default.

    To create more conditions, first create this balance configuration and then you can edit it. For more information, refer to Edit an existing balance configuration.

    Your options vary depending on whether you selected a debit or credit program earlier. Refer to the following table for descriptions of each condition. You can also find this information in the tooltips in Control Center.

Credit programs

ConditionDescriptionOptionsSpecial instructions
Amount considerChecks if the account has enough limit or balance Contract amount is the total amount, including the principal amount, interest, and fees.

Principal amount is the original amount, excluding interest and fees.
ConsiderSpecifies which limits and balances should be checked before approving a transactionAvailable credit limit is the portion of a card holder's total credit limit that is available for use.

Available withdrawal credit is the amount a cardholder can withdraw from their credit account, after accounting for previous withdrawals and related transactions.

Available total installment credit is the amount of credit still available for purchases made in installments within a credit account.
When selecting multiple options, keep in mind that they interact differently based on your choices.

(available credit limit + over-limit) = the transaction is checked against the sum of these two options

(available credit limit + over-limit) & available withdrawal credit = the transaction is checked against the sum of available credit limit + over-limit, and it’s also separately checked against the amount of available withdrawal credit

(available credit limit & available withdrawal credit) = the transaction is checked against both amounts separately
ImpactSpecifies the limits or balances to credit or debit using the contract amountAvailable credit limit is the portion of a cardholder's total credit limit that is available for use. It’s based on the initial total credit limit and any debit and credit activity on the account.

Available withdrawal credit is the amount a cardholder can withdraw from their credit account, after accounting for previous withdrawals and related transactions.

Available total installment credit is the amount of credit still available for purchases made in installments within a credit account.

This value is based on the total installment credit limit set for the account and is reduced as installment-based transactions are made. It helps determine whether a customer can make additional purchases using installment plans.

Debit programs

ConditionDescriptionOptionsSpecial instructions
Amount considerChecks if the account has enough limit or balance Contract amount is the total amount, including the principal amount, interest, and fees.

Principal amount is the original amount, excluding interest and fees.
ConsiderSpecifies which limits and balances should be checked before approving a transactionAvailable credit limit is the available balance in a cardholder’s checking account.

Available savings account limit is the money in a savings account that is currently accessible.

Held funds are amounts in an account that are temporarily blocked from use.

Additional funds are extra money added to an account to increase the total available balance, such as a promotional credit or bonus.
When you select Available credit limit, the transaction is automatically checked against the sum of available credit limit + available savings account limit + overdraft limit.
ImpactSpecifies the limits or balances to credit or debit using the contract amountAvailable credit limit is the available balance in a cardholder’s checking account.

Available savings account limit is the money in a savings account that is currently accessible.

Held funds are amounts in an account that are temporarily blocked from use.

Additional funds are extra money added to an account to increase the total available balance, such as a promotional credit or bonus.
Opposite impactSpecifies the limits or balances where funds should be transferred to offset the option chosen for ImpactSame as Impact
  1. Review the conditions you created in the Conditions created field, then select Next.
  2. On the Review and create balance configurationscreen, ensure the information is correct. If you want to change anything, select Back. When you’re satisfied with all the information, select Create.

Activate or deactivate a balance configuration

You can create a balance configuration as active (immediately activated) or as inactive (saved but not activated) and activate it later.

To activate an inactive balance configuration:

  1. From the main menu, select Configurations > Balance configurations.
  2. Select the inactive balance configuration you want to activate.
  3. On the Balance configuration details screen, select your configuration.
  4. On the Scenario details screen, set the Inactive toggle switch to Active.

To deactivate a balance configuration at any time, use the previous steps and set the Active toggle switch to Inactive.


Related pages

Once you've created a balance configuration, you can change it as needed.