Fidel platform supports two distinct types of offers to enhance flexibility and customisation for you:
- Fidel's Marketplace Offers
- My Programs' Offers
Fidel's Marketplace Offers
Fidel Marketplace Offers are curated by Fidel and represent a selection of high-quality offers sourced by Fidel and/or by Fidel's partners. These offers:
- Are stored in a centralised database accessible across the platform
- Are not tied to any individual client or client program
- Reflect offers collected, vetted, and managed by Fidel's team
- These offers are readily available for clients to browse and select which offers you want to move into My Program’s Offers
Marketplace Offer Fields
| Field | Type | Description |
|---|---|---|
| id | string | Unique identifier for the object. |
| accepted | boolean | Whether the Offer was accepted by the Brand. |
| activation | object | Contains an enabled flag and qualifiedTransactionsLimit to specify if and how an offer needs activation. |
| additionalTerms | string | null | Additional Terms & Conditions related to the Offer. |
| brandId | string | Unique identifier of the associated Brand. |
| brandLogoURL | string | null | Logo URL of the associated Brand. |
| brandName | string | Name of the associated Brand. |
| budget | object | Contains the budget rules for the offer, with limit, period, and unit properties. |
| channels | array: string | The channels where the offer is valid (e.g., "online", "instore"). |
| countryCode | string | ISO 3166-1 alpha-3 country code where the Offer is active. |
| created | date | ISO 8601 timestamp in UTC for when the Offer was created. |
| currency | string | ISO 4217 currency code for the offer's transactions. |
| customerRecency | object | Rules for customer recency, containing enabled (boolean) and days (number) properties. |
| daysOfWeek | array: number | Array of numbers (0-6, Sunday-Saturday) representing the active days for the Offer. |
| endDate | date | null | The local date and time when the Offer expires (YYYY-MM-DDThh:mm:ss). null for non-expiring offers. |
| feeSplit | number | null | The amount awarded to the publisher as a fee, applied as a fixed amount or percentage based on the offer type. |
| fees | object | Contains the fee structure, with fidelFee and/or publisherFee properties. |
| funded | object | Contains the id and type ("card-linking" | "affiliate") of the account funding the Offer. |
| live | boolean | Whether the Offer exists in the live or test Fidel environment. |
| longDescription | string | A detailed description of the offer or brand. |
| maxPaymentTimeline | number | The maximum number of days for payment processing. |
| maxRedemptions | object | Contains redemption limits for a user, with transactionsLimit, period, and unit properties. |
| maxTransactionAmount | number | Maximum transaction amount that will generate a proportional reward. |
| metadata | object | null | A key-value object for any custom data associated with the Offer. |
| minCashback | number | The minimum cashback amount for the offer. |
| minTransactionAmount | number | Minimum transaction amount required to qualify for the Offer. |
| name | string | Name of the Offer. |
| origin | object | Contains the id and type ("card-linking" | "affiliate") of the account that created the Offer. |
| priority | number | Not in use. This value is always 1. |
| programsLinkCount | number | The total number of programs linked to this offer. |
| programsLinkStatus | array: object | An array of objects detailing the status and id of each program link. |
| publisherId | string | Unique identifier of the Publisher (refers to accountId). |
| requiresApproval | boolean | Indicates if the offer requires approval before it can be used. |
| returnPeriod | number | null | The number of days after a transaction occurs before it qualifies for the offer reward. |
| schemes | array: string | Card Schemes for which the Offer is valid. Can include visa, mastercard, and amex. |
| shortDescription | string | A brief, summary description of the offer. |
| startDate | date | The local date and time when the Offer becomes active (YYYY-MM-DDThh:mm:ss). |
| supplier | string | object | The name of the offer supplier or an object containing supplier details. |
| supplierId | string | The unique identifier for the offer supplier. |
| transactionSource | string | The source of the transaction (e.g., "oaas"). |
| type | object | Represents the reward type. Has a name ("amount" or "discount"), a value, and a maxRewardAmount for discount types. |
| updated | date | ISO 8601 timestamp in UTC for when the Offer was last updated. |
My Programs' Offers
My Programs' Offers represent offers that are customised specifically for your program. They might be:
- Offers that you source on your own. These offers are manually created by you on the Fidel Platform through the following endpoint: Create Offer Endpoint
- Selected Fidel Marketplace Offers: These are offers that you have selected from Fidel’s Marketplace Offers to be used in your program. Once here, it can now be tailored to the needs and preferences of your program and made accessible to your enrolled customer base. To select a Fidel's Marketplace Offer to a program the following endpoint can be used: Create Offer from Marketplace Offer
Once an Offer is created — whether sourced directly by you or selected from a Fidel Marketplace Offer — it becomes available as a My Programs' Offer through the respective List Offers / Get Offer endpoints, allowing you and your customers to easily access these offers.
The flexibility of the Fidel platform allows you to leverage offers secured by Fidel and the ability to load and manage them all in a single location My Program’s Offers.
Programs Offer Fields
| Field | Type | Description |
|---|---|---|
| id | string | Unique identifier for the object. |
| accepted | boolean | Whether the Offer was accepted by the Brand. |
| activation | object | Contains an enabled flag and qualifiedTransactionsLimit to specify if and how an offer needs activation. |
| additionalTerms | string | null | Additional Terms & Conditions related to the Offer. |
| brandId | string | Unique identifier of the associated Brand. |
| brandLogoURL | string | null | Logo URL of the associated Brand. |
| brandName | string | Name of the associated Brand. |
| budget | object | Contains the budget rules for the offer, with limit, period, and unit properties. |
| countryCode | string | ISO 3166-1 alpha-3 country code where the Offer is active. |
| created | date | ISO 8601 timestamp in UTC for when the Offer was created. |
| currency | string | ISO 4217 currency code for the offer's transactions. |
| daysOfWeek | array: number | Array of numbers (0-6, Sunday-Saturday) representing the active days for the Offer. |
| endDate | date | null | The local date and time when the Offer expires (YYYY-MM-DDThh:mm:ss). null for non-expiring offers. |
| feeSplit | number | null | The amount awarded to the publisher as a fee, applied as a fixed amount or percentage based on the offer type. |
| fees | object | Contains the fee structure, with fidelFee and publisherFee properties. |
| funded | object | Contains the id and type ("card-linking" | "affiliate") of the account funding the Offer. |
| live | boolean | Whether the Offer exists in the live or test Fidel environment. |
| maxRedemptions | object | Contains redemption limits for a user, with transactionsLimit, period, and unit properties. |
| maxTransactionAmount | number | Maximum transaction amount that will generate a proportional reward. |
| minTransactionAmount | number | Minimum transaction amount required to qualify for the Offer. |
| metadata | object | null | A key-value object for any custom data associated with the Offer. |
| name | string | Name of the Offer. |
| origin | object | Contains the id and type ("card-linking" | "affiliate") of the account that created the Offer. |
| priority | number | Not in use. This value is always 1. |
| publisherId | string | Unique identifier of the Publisher (refers to accountId). |
| returnPeriod | number | null | The number of days after a transaction occurs before it qualifies for the offer reward. |
| schemes | array: string | Card Schemes for which the Offer is valid. Can include visa, mastercard, and amex. |
| startDate | date | The local date and time when the Offer becomes active (YYYY-MM-DDThh:mm:ss). |
| supplier | object | null | Contains the id and type ( "card-linking" | "affiliate") of the account supplying the Offer. |
| type | object | Represents the reward type. Has a name ("amount" or "discount"), a value, and a maxRewardAmount for discount types. |
| updated | date | ISO 8601 timestamp in UTC for when the Offer was last updated. |