Program parameters reference table

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

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 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

Accrual projection calculation method

0 - Disabled, 1 - LINEAR PROJECTION (accruals projected from cycle closing to the due date).

Credit programs

INTEGER

 

0

Accrual rate discount

[Outdated] Discount on OVERDUE and REFINANCING accruals. Does not apply to IOF.

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

[Outdated - restricted] Automatically generate bank accounts upon account creation.

 

BOOLEAN

 

0 (false)

Allow account creation using an existing external_id

Allow account creation using existing account external id by Org.

All programs

BOOLEAN

 

0 (false)

Allow creating entities without a document number

Allow creating an object without a document_number.

 

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 earmarking

Allow earmarking (set aside some amount of money from the total funds for later use).

 

BOOLEAN

 

0 (false)

Allow multiple physical cards

Allow more than one physical card to consume the same balance.

 

BOOLEAN

 

0 (false)

Allow sending card passwords via SMS

If TRUE, allow sending card passwords via SMS password to card.

 

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)

Allow transfr/cash-in

Allow accounts to receive funds transfer/cashin.

BOOLEAN

0 (false)

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

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

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

Card expiration (# of months)

Number of months to add to the current date to set card expirations.

 

INTEGER

 

72

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

Contract bind allowed

If TRUE, a contract can be bound to an account from a specific program.

 

BOOLEAN

N/A

0 (false)

Create physical card when creating accounts

When creating an account, also create a physical card (for account owner).

 

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

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

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

DIFOP

[Outdated - restricted] Refers to the revenue from overdue charges up to 59 days.

 

DECIMAL

 

0

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)

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)

Enable accounts creation

Enable accounts creation

All programs

BOOLEAN

 

1 (true)

Exchange rate expiration

Exchange rate expiration period (days).

 

INTEGER

 

0

Generate random password on card creation

If TRUE, generate random passwords for new cards (user can only change afterward).

 

BOOLEAN

 

0 (false)

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

Interest rate period

The number of days in the interest rate period. This parameter can be used to configure different periods for interest rates, such an annual or monthly period. Refer to Changing the interest rate period for more information.

Credit programs

INTEGER

365

30 (monthly)

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)

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 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)

IOF International fee

[Outdated] IOF fee for international purchases.

All programs

DECIMAL

 

6.38

IOF monthly fee

[Outdated] IOF monthly fee on a credit operation (revolving, invoice installment and invoice agreement).

Credit programs

DECIMAL

 

0.38

Itaú transfer discount

[Outdated - restricted] Used to apply discount on specific Itaú transfer flows.

 

DECIMAL

N/A

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

Mailed statements fee

Fee for sending statement via mail.

DECIMAL

0

Max name length on physical card

Maximum number of characters for the cardholder's name on a pphysical card.

INTEGER

25

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

Maximum credit limit

(Credit programs only) Overall maximum credit limit for credit accounts in the program.

Credit programs

DECIMAL

 

1000

Maximum number of card holders

Limits the maximum number of additional card holders for an account.

 

INTEGER

 

 

Maximum percentage of first payment

Minimum percentage of first payment to effect a statement agreement (v2 and v3 endpoints only).

Credit programs

DECIMAL

10

Maximum recharge value

Maximum recharge amount

DECIMAL

2500

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

Merchant discount rate

Merchant Discount Rate (prepayment discount percentage for merchants).

 

INTEGER

 

 

Minimum boleto

When the statement amount is less than this value, the outstanding balance does not accrue interest.

Credit programs

DECIMAL

 

0

Minimum credit limit

(Credit programs only) Overall minimum credit limit for credit accounts in the program.

Credit programs

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 value (payment refinancing)

Minimum amount of each installment of a refinancing agreement (v2 and v3 endpoints only).

Credit programs

Decimal

-

7

Minimum recharge value

Minimum recharge value

DECIMAL

0

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 installment payment

Minimum amount of each installment of a statement agreement (v2 and v3 endpoints only).

Credit programs

Decimal

-

15

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

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

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

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

Percentage of income that will be for global limit for account

Percentage of income that will be for global limit for account

 

Decimal

 

0

Provisional global limit

Provisional Global Limit

 

Decimal

 

0

Send email notification upon payment

If TRUE, send email notifications upon processing any bank/gateway/authorizer payment.

 

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

Send SMS notification upon payment

If TRUE, send SMS notifications upon processing any bank/gateway/authorizer payment.

 

BOOLEAN

 

0 (false)

Set EventDate in accounting entries to work days

If this parameter is set to true, the EventDate field in accounting entries will contain dates for only work days. For example, if an accounting entry is created on a non-work day such as Saturday, the EventDate for this accounting entry will be the date of the next work day such as Monday. If this parameter is set to false, the EventDate field in accounting entries will contain dates for both work and non-work days. In this case, if an accounting entry is created on a Saturday, the EventDate will be that Saturday’s date.

All programs

Boolean

-

1 - True

Set external id as main key for accounts

Use external_id as main key instead of document_number.

 

BOOLEAN

 

0 (false)

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)

Statement balance refinancing rate

Rate for refinancing a statement balance (v2 and v3 endpoints only).

Credit programs

DECIMAL

-

5.99

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

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

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

Wrong password attempts

Number of wrong password attempts allowed before blocking the card.

All

INTEGER

3