Offers Configuration

The Offer entity enables the configuration of all costs associated with using a credit card product, from regular and overdue interest rates applied to purchases to additional fees such as maintenance fees or insurance costs.

To support different value propositions and Product types, multiple Offer types can be associated with the same Product. The configurable parameters for each Offer are detailed below:

Name – Name of the Offer.

Description – Description of the Offer.

Minimum amount – Minimum value of the transaction, fee, cost, etc., associated with the Offer.

Maximum amount – Maximum value of the transaction, fee, cost, etc., associated with the Offer.

Type – The type of Offer being configured. The available options are:

Standard – Regular Offer for card transactions.
Fee – Used for setting up fees and additional costs. A Product can only have one Fee-type Offer, but multiple costs can still be configured for the same Product, and they will behave the same way.
Initial Promotion – Used when offering an introductory benefit to customers, such as a preferential interest rate during the first billing cycle.
Refinance – The Offer used for debt refinancing cases.
Debit Adjustment – Should be configured when debit-type adjustments need to be made to an account, such as accounting adjustments.

Credit Type – For Standard Offers, this parameter defines whether the associated transactions should be included in the revolving credit logic or the installment-based logic.

Additionally, each Offer must be linked to at least one Condition, which has the following configurable parameters:

Condition Type – The type of concept being associated with the Offer. The available options are:

Principal
Regular interest
Overdue interest
Cost
Collection cost

For example, a Standard Offer configured to apply interest to card transactions could be associated with three conditions: one for principal, one for regular interest, and one for overdue interest.

Is Active by Default – This parameter allows configuring costs that are initially inactive. For example, if a Product accrues daily interest from the purchase date until the due date for the minimum payment, but those interests are only charged if the customer pays at least the amount required to avoid interest, this parameter should be set to 'False' for the corresponding Offer.

Interest Type – This parameter defines the type of interest applied to customer transactions. The available options are:

Simple – Based on the principal balance.
Compound – Based on all costs associated with the transaction (e.g., regular and overdue interest).
Average Balance – Based on the daily average balance used for interest calculation.

Grace Period – Allows configuring a grace period before the specified cost starts accruing. The period can be set in days, weeks, or months.

Frequency – For cost-related Offers, this parameter defines how often the cost is generated. For example, to configure daily interest accrual, the frequency should be set to quantity: '1', type: 'daily'. If you are creating a monthly administrative cost, the configuration here would be quantity: '1', type: 'month'.

Tax – The tax applied to the configured concept.

Value Details – This parameter configures the details of the cost value, with the following attributes:

Type – Whether the value is a fixed amount or a percentage.
Value – The amount used for calculations. If it is a fixed amount, the value is in currency units; if it is a percentage, the corresponding percentage value.
Base – The basis used for cost calculation:
- Principal – The base is the principal debt.
- Total Debt – The base is the total outstanding debt.
- Payment Promise – The base is the generated payment promise amount.
- Line of Credit – The base is the customer’s credit line.