Program parameters reference
Preserve for internal reference only!
Program parameters are configurable properties that manage how a Program is set up and how it behaves. For example, the Allow multiple physical cards
parameter (when set to true
) allows more than one physical card to draw from the same account balance.
The following table provides basic information about the available parameters, including their type and whether they are required for specific types of programs.
Display Name |
Description |
Required for ... |
Value type |
Max Length |
Default Value |
Allow multiple physical cards |
Allow more than one physical card to consume the same balance. |
|
BOOLEAN |
|
0 (false) |
Accounting MDR |
[Outdated - restricted] MDR (merchant discount rate) – Pre-payment discount percentage for merchants. |
|
PERCENTAGE |
|
0 |
Accounting RAV |
[Outdated - restricted] RAV (pre-payment of receivables) – Pre-payment discount percentage for pre-payment of credit card settlements. |
|
PERCENTAGE |
|
0 |
Accrual rate discount |
[Outdated] Discount on OVERDUE and REFINANCING accruals. Does not apply to IOF. |
Credit programs |
INTEGER |
|
0 |
Accrual calculation strategy |
Parameter to define the start date for daily accruals: 0 - Normal (Due Date +1) / 1 - Calculation goes back to debit’s date (first installment: transaction date + 1; other installments: corresponding cycle start date + 1). |
Credit programs |
INTEGER |
|
0 |
Interest projection reversal |
Defines whether the projected interest between the cut (closing) and the due date of the invoice should be reversed if any payment occurs before the due date: 0 - Do not reverse), 1 - Reverse |
Credit programs |
INTEGER |
|
0 |
Accrual projection calculation method |
0 - Disabled, 1 - LINEAR PROJECTION (accruals projected from cycle closing to the due date). |
Credit programs |
INTEGER |
|
0 |
Accrual reversal strategy |
Parameter responsible for configuring the accrual reversal strategy in the event of a purchase cancellation. |
Credit programs |
INTEGER |
|
0 |
Allow account creation using an existing external_id |
Allow account creation using existing account external id by Org. |
All programs |
BOOLEAN |
|
0 (false) |
Allow earmarking |
Allow earmarking (set aside some amount of money from the total funds for later use). |
|
BOOLEAN |
|
0 (false) |
Allow document_number reuse |
Allow more than one account to be created for the same document_number in the same program. |
|
BOOLEAN |
|
0 (false) |
Allow creating entities without a document number |
Allow creating an object without a document_number. |
|
BOOLEAN |
|
0 (false) |
Allow tokenized transactions with new card on file |
Allow approval of tokenized transactions with cards in CREATED status (but not yet activated). |
Debit programs |
BOOLEAN |
|
0 (false) |
Enable accounts creation |
Enable accounts creation |
All programs |
BOOLEAN |
|
1 (true) |
Allow account creation |
[Outdated - restricted] Automatically generate bank accounts upon account creation. |
|
BOOLEAN |
|
0 (false) |
Approve rules authorization |
If TRUE (and if spending controls are configured), authorizations are approved by default when the response from the rules-api includes an error. |
Debit programs |
BOOLEAN |
|
0 (false) |
Approve rules cancellation |
If TRUE, deny authorizations by default if Rules API is unavailable. |
|
BOOLEAN |
|
0 (false) |
ATC maximum offset |
When comparing the current ATC value received with the values registered in our database. The difference must be less than this value. |
All programs |
INTEGER |
|
15 |
ATC minimum offset |
When comparing the current ATC value received with the values registered in our database. The difference must be greater than this value. |
All programs |
INTEGER |
|
5 |
Internal authorizations |
If TRUE, ignore the issuer's denial. This allows adaptation to different compliance rules or to create an extra layer of security. |
|
BOOLEAN |
|
1 (true) |
Contract bind allowed |
If TRUE, a contract can be bound to an account from a specific program. |
|
BOOLEAN |
N/A |
0 (false) |
Due Date Exchange Control |
Flag for validating the change of expiration dates. If TRUE, you cannot change the due date more than once per cycle. Valid only if STANDARD CALENDAR SELECTION = false. |
Credit programs |
BOOLEAN |
|
1 (true) |
Delinquency buckets |
Defines if the delinquency buckets should be calculated for tracking an account's debt: 0 - Do not calculate, 1 - Calculate and amortize buckets from oldest to newest |
Credit programs |
INTEGER |
|
0 |
Itaú transfer discount |
[Outdated - restricted] Used to apply discount on specific Itaú transfer flows. |
|
DECIMAL |
N/A |
0 |
Number of days before due date to set the closing date of the statement |
Number of days before due date to set the closing date of the statement. |
Credit programs |
INTEGER |
|
10 |
Number of days to block the account for unpaid statement |
Number of days after due date to block the account for nonpayment. |
Credit programs |
INTEGER |
|
10 |
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) |
Credit programs |
INTEGER |
|
5 |
DIFOP |
[Outdated - restricted] Refers to the revenue from overdue charges up to 59 days. |
|
DECIMAL |
|
0 |
Emboss an additional card |
(Private label cards only) Specifies that the addional card will be sent to embossing. |
|
BOOLEAN |
|
0 (false) |
Emboss card with no address |
Allow cards without an address to be sent for embossing. |
|
BOOLEAN |
|
0 (false) |
Send email notification upon payment |
If TRUE, send email notifications upon processing any bank/gateway/authorizer payment. |
|
BOOLEAN |
|
0 (false) |
Send SMS notification upon payment |
If TRUE, send SMS notifications upon processing any bank/gateway/authorizer payment. |
|
BOOLEAN |
|
0 (false) |
Allow sending card passwords via SMS |
If TRUE, allow sending card passwords via SMS password to card. |
|
BOOLEAN |
|
0 (false) |
Set external id as main key for accounts |
Use external_id as main key instead of document_number. |
|
BOOLEAN |
|
0 (false) |
Generate random password on card creation |
If TRUE, generate random passwords for new cards (user can only change afterward). |
|
BOOLEAN |
|
0 (false) |
Defines the number of additional grace days granted to the program. |
Programs 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. |
Credit programs |
INTEGER |
- |
0 |
Exchange rate expiration |
Exchange rate expiration period (days). |
|
INTEGER |
|
0 |
IOF daily rate |
[Outdated - restricted] IOF daily tax rate on a credit operation (revolving, installment billing and invoice settlement). |
Credit programs |
DECIMAL |
|
0,0082 |
IOF monthly fee |
[Outdated] IOF monthly fee on a credit operation (revolving, invoice installment and invoice agreement). |
Credit programs |
DECIMAL |
|
0.38 |
IOF International fee |
[Outdated] IOF fee for international purchases. |
All programs |
DECIMAL |
|
6.38 |
IOF first day |
[Outdated] If TRUE, revolving IOF charge on unpaid debit balance always occurs on the first day of the month. |
Credit programs |
BOOLEAN |
|
0 (false) |
Configure a fine amount for late payment |
Set a fine amount and use it to calculate and post a transaction at each cycle closing if the rules are satisfied. |
Credit accounts |
DECIMAL |
|
0 |
Maximum credit limit |
(Credit programs only) Overall maximum credit limit for credit accounts in the program. |
Credit programs |
DECIMAL |
|
1000 |
Minimum credit limit |
(Credit programs only) Overall minimum credit limit for credit accounts in the program. |
Credit programs |
DECIMAL |
|
0 |
Provisional global limit |
Provisional Global Limit |
|
Decimal |
|
0 |
Limit transactions for temporary cards |
Transaction limit amount of a temporary type card. The amount on the card is renewed every time the Issuer renews the card. Counts only authorized transactions. |
|
INTEGER |
|
14 |
Maximum number of card holders |
Limits the maximum number of additional card holders for an account. |
|
INTEGER |
|
|
Merchant discount rate |
Merchant Discount Rate (prepayment discount percentage for merchants). |
|
INTEGER |
|
|
Minumum deposit amount |
For an interest-bearing account, accrual adjustments depend on interest-rate and period rules. By establishing a minimum amount to be applied, a minimum amount is required for each deposit. |
|
DECIMAL |
|
100 |
Minimum payment calculation method |
Method for calculating minimum amount due (MAD). |
Credit programs |
INTEGER |
|
0 |
|
|||||
0 - Brazillian model: 100% outstanding balance of previous statements + percentage of statement transactions prior to cycle closing. |
|||||
|
|||||
1 - Argentina model: percentages of all transactions prior to the cycle closing. |
|||||
|
|||||
2 - Indian model: 100% of the outstanding overdue and overlimit amounts |
|||||
Minimum boleto |
[Outdated] When the statement amount is less than the value configured as MINIMO BOLETO, the outstanding balance does not accrue interest. |
Credit programs |
DECIMAL |
|
0 |
Non-business days |
Days of the week to be considered non-business days: 1 - Monday, 2 - Tuesday, 3 - Wednesday, 4 - Thursday, 5 - Friday, 6 - Saturday, 7 - Sunday. |
Credit programs |
INTEGER |
n/a |
67 |
Maximum refinancing installments (v2 and v3 endpoints only) |
Maximum number of installments that a refinancing can take (v2 and v3 endpoints). |
Credit programs |
INTEGER |
|
18 |
Card expiration (# of months) |
Number of months to add to the current date to set card expirations. |
|
INTEGER |
|
72 |
Create physical card when creating accounts |
When creating an account, also create a physical card (for account owner) |
|
BOOLEAN |
|
0 (false) |
Opt-in savings account |
Flag indicating whether the account is an interest-bearing account. |
|
BOOLEAN |
|
0 (false) |
Overdue fee calculation method |
0 - late fee applied on 100% of the remaining balance of overdue transactions; 1 - late fee applied only to the minimum payment of the balance of overdue transactions. |
Credit programs |
INTEGER |
|
0 |
Overlimit fee amount |
Fee applied if the customer exceeds the card limit (if allowed for the account). This fee is charged at the end of the invoice cycle. |
Credit programs |
DECIMAL |
|
0 |
Annuity Installments |
Number of installments to pay annuity. When parameterized, automatically divides the value of the annuity into the number of installments. And it will create a transaction of type annuity in the customer statement. |
Credit programs |
INTEGER |
|
0 |
Percentage of income that will be for global limit for account |
Percentage of income that will be for global limit for account |
|
Decimal |
|
0 |
Withdrawal limit percentage |
Maximum allowed percentage for withdrawals and payments. This value is a percentage of the maximum credit limit granted by the institution to users of this program. This value is set in decimal places. For example, to set a withdrawal limit of 10%, use 0.1 |
Credit programs |
DECIMAL |
|
1 |
Maximum percentage of first payment |
Maximum percentage of first payment to effect a statement agreement (v2 and v3 endpoints only). |
Credit programs |
DECIMAL |
|
90 |
Maximum percentage of first payment |
Minimum percentage of first payment to effect a statement agreement (v2 and v3 endpoints only). |
Credit programs |
DECIMAL |
|
10 |
Allow transfr/cash-in |
Allow accounts to receive funds transfer/cashin. |
|
BOOLEAN |
|
0 (false) |
Send password via SMS |
If TRUE, enables sending password via SMS when creating an account. |
|
BOOLEAN |
|
0 (false) |
Send rules authorization |
If spending controls are configured), evaluate rules using Rules API (default) or with some other rules. To call rules v1 endpoint, set value to `2`; to call rules v2 endpoint, set value to `1`. |
|
INTEGER |
|
2 |
Skip auto-renewal of temporary cards |
By default, a temporary card is renewed when the PCI data is consulted. When this parameter is defined as TRUE, the renewal is skipped. |
|
BOOLEAN |
|
0 (false) |
Stop accrual # of days |
Maximum days in arrears for which the calculation of fees, interest ,and fines will be posted. The platform won’t post any accrued amount that was calculated after the STOP_ACCRUAL number of days. You can still post these accruals manually using the Statements API. |
Credit programs |
INTEGER |
- |
63 |
Max name length on physical card |
Maximum number of characters for the cardholder's name on a pphysical card. |
|
INTEGER |
|
25 |
Mailed statements fee |
Fee for sending statement via mail. |
|
DECIMAL |
|
0 |
Statement balance refinancing rate |
Rate for refinancing a statement balance (v2 and v3 endpoints only). |
Credit programs |
DECIMAL |
- |
5.99 |
Wrong password attempts |
Number of wrong password attempts allowed before blocking the card. |
All |
INTEGER |
|
3 |
Timeline Category display name |
Display name for the Category field of a timeline. |
|
INTEGER |
|
|
Timeline Type display name |
Display name for the Type field of a timeline. |
|
INTEGER |
|
|
Annuity fee amount |
Fee to be charged per annuity on the anniversary of the account. Must be configured in conjunction with the Annuity Installment parameter. It is releted to parameter PARCELAS ANUIDADE. |
Credit programs |
Decimal |
|
0 |
Maximum recharge value |
Maximum recharge amount |
|
DECIMAL |
|
2500 |
Maximum amount entered according to the invoice |
Maximum amount for first payment in the execution of a statement agreement (v2 and v3 agreement endpoints only). |
Credit programs |
Decimal |
- |
30000000 |
Minimum recharge value |
Minimum recharge value |
|
DECIMAL |
|
0 |
Minimum down payment |
Minimum down payment amount for effecting a payment agreement (v2 and v3 endpoints only). |
Credit programs |
Decimal |
- |
15 |
Minimum installment payment |
Minimum amount of each installment of a statement agreement (v2 and v3 endpoints only). |
Credit programs |
Decimal |
- |
15 |
Minimum installment value (payment refinancing) |
Minimum amount of each installment of a refinancing agreement (v2 and v3 endpoints only). |
Credit programs |
Decimal |
- |
7 |
Updated 11 months ago