Program parameters

Program parameters are configurable properties that manage how a program is set up and how it behaves. The following table provides basic reference information about program parameters and whether they are required—that is, automatically assigned to a program depending on its program type.

Program parameters come with default values. To change the value of a program parameter, use Pismo Control Center. Alternatively, you can use the API endpoints.

In the Constraints column, every program parameter is labeled as required, optional, or not allowed for each program type.

  • If it's not allowed, you can't assign the parameter to that program type.
  • If it's optional, you can use the Link optional parameter to program endpoint to assign it to the program, then use Control Center or the API to update its value.
📘

Notes:

  • The Display name column shows the name of the program parameter as it appears in Control Center.
  • The Account parameter? column indicates whether there is a corresponding account parameter. For more information, refer to the Account parameters guide.
  • In the Constraints column, '0' is short for 'zero'. For example, 'PREPAID 0 BALANCE' means 'PREPAID ZERO BALANCE'.
  • Entries marked N/A indicate Not Applicable.
  • The program parameter ID is not included in the table because it can change depending on the environment. Use the List program parameters endpoint to get a list of the parameters for your program that includes their IDs.
  • Parameters that are flagged as restricted in their description are only applicable to certain customers.
  • If a parameter is flagged as outdated, another, preferred, method is now available to perform the same task. The parameter can still be used, however.
Display name
Applies to
Description
Account parameter?
Constraints
Value type
Default value
Category
Account financial classificationThis is used in audit in accounting register to compare the generated accruals.Yescredit: REQUIRED
debit: not allowed
prepaid: not allowed
credit 0 balance: not allowed
debit 0 balance: not allowed
prepaid 0 balance: not allowed
merchant: not allowed
current accounts: not allowed
internal accounts: not allowed
correspondent accounts: not allowed
transport: not allowed
integer0
Accounting MDR[Outdated - restricted] MDR (merchant discount rate) – Pre-payment discount percentage for merchants.Nocredit: not allowed
debit: not allowed
prepaid: not allowed
credit 0 balance: not allowed
debit 0 balance: not allowed
prepaid 0 balance: not allowed
percent0Parameter
Accounting RAV[Outdated - restricted] RAV (pre-payment of receivables) – Pre-payment discount percentage for pre-payment of credit card settlements.Nocredit: not allowed
debit: not allowed
prepaid: not allowed
credit 0 balance: not allowed
debit 0 balance: not allowed
prepaid 0 balance: not allowed
percent0Parameter
Accrual calculation strategyAccrual generation and reversalDefines the start date for daily accruals.
0 - Normal (Due date +1)
1 - Calculation goes back to debit date. (First installment: transaction date + 1. Other installments: corresponding cycle start date + 1).
The Pismo platform uses the date defined in this parameter to calculate interest charges for each transaction category. If the parameter is set to start interest from the due date, but you want cash withdrawals to accrue interest from the transaction date instead, use the Create transaction category endpoint.
Nocredit: REQUIRED
debit: not allowed
prepaid: not allowed
credit 0 balance: not allowed
debit 0 balance: not allowed
prepaid 0 balance: not allowed
integer0Parameter
Accrual minimum amount to be postedAccrual generation and reversalEnables minimum value rule for accruals at the time of posting. When enabled, the platform checks whether the sum of charges generated is lower than the configured minimum value. If so, the value defined in the configuration is posted. Otherwise, the sum of the charges is posted.Nocredit: optional
debit: not allowed
prepaid: not allowed
credit 0 balance: not allowed
debit 0 balance: not allowed
prepaid 0 balance: not allowed
merchant: not allowed
current accounts: not allowed
internal accounts: not allowed
correspondent accounts: not allowed
parameter transport: not allowed
boolean0 (false)Parameter
Accrual projection calculation methodAccrual projection from cycle closing to due date0 - Disabled, 1 - LINEAR PROJECTION (accruals projected from cycle closing to the due date).Nocredit: REQUIRED
debit: not allowed
prepaid: not allowed
credit 0 balance: not allowed
debit 0 balance: not allowed
prepaid 0 balance: not allowed
integer0Parameter
Allow account creation[Outdated - restricted] Automatically generate bank accounts upon account creation.Nocredit: optional
debit: optional
prepaid: optional
credit 0 balance:optional
debit 0 balance: optional
prepaid 0 balance: optional
boolean0 (false)Parameter
Allow document_number reuseAllow more than one account to be created for the same document_number in the same program.Nocredit: optional
debit: not allowed
prepaid: not allowed
credit 0 balance: not allowed
debit 0 balance: not allowed
prepaid 0 balance: not allowed
boolean0 (false)Parameter
Allow multiple physical cardsEmbossingAllow more than one physical card to consume the same balance.Nocredit: REQUIRED
debit: REQUIRED
prepaid: REQUIRED
credit 0 balance: REQUIRED
debit 0 balance: REQUIRED
prepaid 0 balance: REQUIRED
boolean0 (false)Card
Allow overriding the minimum amount due for the current statementMAD calculationEnables overriding the minimum amount due for the current statement.Yescredit: optional
debit: not allowed
prepaid: not allowed
credit 0 balance: not allowed
debit 0 balance: not allowed
prepaid 0 balance: not allowed
boolean0 (false)
Allow program migration between different brandsIf TRUE, the program can receive accounts from programs with a different brand than the current one.Nocredit: optional
debit: optional
prepaid: optional
credit 0 balance: optional
debit 0 balance: optional
prepaid 0 balance: optional
merchant: optional
current accounts: optional
internal accounts: optional
correspondent accounts: optional
parameter transport: optional
boolean0 (false)Parameter
Allow sending card passwords via SMSIf TRUE, allow sending card passwords via SMS password to card.Nocredit: not allowed
debit: not allowed
prepaid: not allowed
credit 0 balance: not allowed
debit 0 balance: not allowed
prepaid 0 balance: not allowed
boolean0 (false)Card
Allow tokenized transactions with new card on fileAllow approval of tokenized transactions with cards in CREATED status (but not yet activated).Nocredit: optional
debit: REQUIRED
prepaid: optional
credit 0 balance: optional
debit 0 balance: optional
prepaid 0 balance: optional
boolean0 (false)Parameter
Allow transfr/cash-in[Restricted] Allow accounts to receive funds transfer/cashin.Yescredit: optional
debit: optional
prepaid: optional
credit 0 balance: optional
debit 0 balance: optional
prepaid 0 balance: optional
boolean0 (false)Parameter
Allows the program to receive an account previously in a different brand program.Allows the program to receive an account previously in a different brand program.Nocredit: optional
debit: optional
prepaid: optional
credit 0 balance: optional
debit 0 balance: optional
prepaid 0 balance: optional
merchant: optional
current accounts: optional
internal accounts: optional
correspondent accounts: optional
transport: optional
boolean0 (false)
Approve rules authorizationIf TRUE (and if spending controls are configured), authorizations are approved by default when the response from the rules-api includes an error.Nocredit: optional
debit: REQUIRED
prepaid: optional
credit 0 balance: not allowed
debit 0 balance: not allowed
prepaid 0 balance: not allowed
boolean0 (false)Parameter
Approve rules cancellationIf TRUE, deny authorizations by default if Rules API is unavailable.Nocredit: optional
debit: optional
prepaid: optional
credit 0 balance: optional
debit 0 balance: optional
prepaid 0 balance: optional
boolean0 (false)Parameter
ATC maximum offsetWhen comparing the current ATC value received with the values registered in our database. The difference must be less than this value.Nocredit: REQUIRED
debit: REQUIRED
prepaid: REQUIRED
credit 0 balance: REQUIRED
debit 0 balance: REQUIRED
prepaid 0 balance: REQUIRED
integer15Card
ATC minimum offsetWhen comparing the current ATC value received with the values registered in our database. The difference must be greater than this value.Nodebit: REQUIRED
credit: REQUIRED
prepaid: REQUIRED
credit 0 balance: REQUIRED
debit 0 balance: REQUIRED
prepaid 0 balance: REQUIRED
integer5Card
Calculate accruals for not due transactionsAccrual generation and reversalIf TRUE, generate accruals for not due transactions of accounts in refinancing.Nocredit: optional
debit: not allowed
prepaid: not allowed
credit 0 balance: not allowed
debit 0 balance: not allowed
prepaid 0 balance: not allowed
merchant: not allowed
current accounts: not allowed
internal accounts: not allowed
correspondent accounts: not allowed
parameter transport: not allowed
boolean0 (false)Parameter
Card expiration (# of months)Number of months to add to the current date to set card expirations.Yescredit: REQUIRED
debit: REQUIRED
prepaid: REQUIRED
credit 0 balance: REQUIRED
debit 0 balance: REQUIRED
prepaid 0 balance: REQUIRED
integer72Parameter
Contract bind allowed[Restricted] If TRUE, a contract can be bound to an account from a specific program.Nocredit: optional
debit: optional
prepaid: optional
credit 0 balance: optional
debit 0 balance: optional
prepaid 0 balance: optional
boolean0 (false)Parameter
Create physical card when creating accountsEmbossingWhen creating an account, also create a physical card (for account owner).Nocredit: optional
debit: optional
prepaid: optional
credit 0 balance: optional
debit 0 balance: optional
prepaid 0 balance: optional
boolean0 (false)Card
Creditor advancement feeDefines a fixed fee to be applied to the transaction, with the same due day as the transaction.Nocredit: not allowed
debit: not allowed
prepaid: not allowed
credit 0 balance: not allowed
debit 0 balance: not allowed
prepaid 0 balance: not allowed
merchant: optional
decimal10Parameter
Creditor discount rateA new transaction is created with the current date and a new counterpart transaction.Nocredit: not allowed
debit: not allowed
prepaid: not allowed
credit 0 balance: not allowed
debit 0 balance: not allowed
prepaid 0 balance: not allowed
merchant: optional
decimal0.025Parameter
Creditor maximum advancement percentageMax percentage that can be anticipated from the merchant schedule.Nocredit: not allowed
debit: not allowed
prepaid: not allowed
credit 0 balance: not allowed
debit 0 balance: not allowed
prepaid 0 balance: not allowed
merchant: optional
decimal1Parameter
Defines the accrual reversal strategy in case of purchase cancellation.Accrual generation and reversalParameter responsible for configuring the accrual reversal strategy in the event of a purchase cancellation.Yescredit: REQUIRED
debit: not allowed
prepaid: not allowed
credit 0 balance: not allowed
debit 0 balance: not allowed
prepaid 0 balance: not allowed
current accounts: not allowed
internal accounts: not allowed
correspondent accounts: not allowed
integer0Parameter
Defines the number of additional grace days granted to the program.Grace daysPrograms with this setting will receive the number of additional grace days configured in addition to the original grace period. Allowed value: from 0 to 10.Nocredit: REQUIRED
debit: not allowed
prepaid: not allowed
credit 0 balance: not allowed
debit 0 balance: not allowed
prepaid 0 balance: not allowed
integer0Parameter
Delayed payment period for boleto (bank slip) (days)[Outdated] Delayed payment # of days for boleto. Calculated either by Due Date or by Real Due Date (if due date falls on a holiday or weekend)Nocredit: REQUIRED
debit: not allowed
prepaid: not allowed
credit 0 balance: not allowed
debit 0 balance: not allowed
prepaid 0 balance: not allowed
integer5Parameter
Delinquency bucket calculationDelinquency bucketDefines if the delinquency buckets should be calculated for tracking an account's debt.
Values:
0 - Do not calculate.
1 - Calculate and amortize buckets from oldest to newest.
Yescredit: REQUIRED
debit: not allowed
prepaid: not allowed
credit 0 balance: not allowed
debit 0 balance: not allowed
prepaid 0 balance: not allowed
integer0Parameter