Product Feed Specifications: Finance Feed

The Finance feed follows the feed specification unique to the Finance vertical. To use the Finance feed, you must first have a feed registered in your CJ Account Manager. The Finance feed is used for financial products such as credit cards.

Several fields in the Finance feed use nested (compound) field types: APR, Fee, Period, Reward, and CustomField. See the Nested Field Types section below for their sub-attribute definitions.

Field Reference

Use the table below to scan all available fields. Click any row to expand full requirements and error details.

Click any row to see type, format, and value examples.

Parameter

Description

Required

id

Unique product identifier assigned by the advertiser.

Required

Type: AlphanumericFormat: Max 100 characters. Allowed special characters: - . # _ /

Note: Must be unique. Products with duplicate IDs will be rejected. Values must contain only valid alphanumeric characters and the allowed special characters.

title

The name of the card, verbatim including registration/trademarks. Make sure all symbols are HTML encoded. Used by the CJ search engine to locate products by keyword.

Required

Type: StringFormat: Max 200 characters

imageLink

Main product image URL.

Required

Type: URLFormat: Max 2000 characters. Must be a valid URL starting with http:// or https://

description

Description of the card or product.

Required

Type: StringFormat: Max 1000 characters

destinationURL

The URL of the page at which a shopper can buy the product.

Required

Type: URLFormat: Max 2000 characters. Must be a valid URL starting with http:// or https://

processingNetwork

The card's processing network. Make sure all symbols are HTML encoded.

Required

Type: StringFormat: Max 100 characters

Examples

Visa

MasterCard

American Express

Discover

creditRating

The credit rating required or targeted for this product.

Required

Type: StringFormat: Max 1000 characters

Examples

Excellent

Good

Fair

nonIntroPurchAPR

The non-introductory purchase Annual Percentage Rate details for this product.

Required

Type: APR (nested)

Note: Mandatory nested field. Must include aprValue, aprType (Fixed or Variable), and aprDescription. Fixed APR type must have only one value; Variable APR type can have multiple. See Nested Field Types below.

nonIntroTransAPR

The non-introductory transfer Annual Percentage Rate details for this product.

Required

Type: APR (nested)

Note: Mandatory nested field. Must include aprValue, aprType (Fixed or Variable), and aprDescription. See Nested Field Types below.

balanceTransFeeValue

How the balance transfer fee should be displayed.

Required

Type: Fee (nested)

Note: Mandatory nested field. Must include feeDescription and either feeValuePercent or feeValueAmount (amount + currency). See Nested Field Types below.

marketingCopy

How marketing member copy should be displayed. Make sure all bullets are HTML encoded.

Required

Type: StringFormat: Max 2000 characters

availableApplications

List of available support applications.

Required

Type: String (comma-separated)Format: Max 1000 characters

publisherGroup

The publisher groups that will have access to the feed contents.

Type: String

Note: Must be a valid publisher group name.

usageType

The usage type for this card.

Type: String (comma-separated)Format: Max 100 characters

Examples

Consumer

Business

cardType

The card type or category.

Type: String (comma-separated)Format: Max 1000 characters

Examples

CoBrand

Lending

Mileage

Rewards

purchGracePeriod

How the purchase grace period should be displayed.

Type: Period (nested)

Note: If used, must include periodDescription, periodValue (numeric), and periodType (Day/Month/Year). See Nested Field Types below.

cashAdvanceAPR

The Cash Advance Annual Percentage Rate details for this product.

Type: APR (nested)

Note: If used, must include aprValue, aprType (Fixed or Variable), and aprDescription. See Nested Field Types below.

penaltyAPR

The Penalty Annual Percentage Rate details for this product.

Type: APR (nested)

Note: If used, must include aprValue, aprType (Fixed or Variable), and aprDescription. See Nested Field Types below.

cashAdvanceFee

How the cash advance fee should be displayed.

Type: Fee (nested)

Note: If used, must include feeDescription and either feeValuePercent or feeValueAmount (amount + currency). See Nested Field Types below.

latePaymentFee

How the late payment fee should be displayed.

Type: Fee (nested)

Note: If used, must include feeDescription and either feeValuePercent or feeValueAmount (amount + currency). See Nested Field Types below.

returnPaymentFee

How the return payment fee should be displayed.

Type: Fee (nested)

Note: If used, must include feeDescription and either feeValuePercent or feeValueAmount (amount + currency). See Nested Field Types below.

overLimitFee

How the over limit fee should be displayed.

Type: Fee (nested)

Note: If used, must include feeDescription and either feeValuePercent or feeValueAmount (amount + currency). See Nested Field Types below.

foreignTransFee

How the foreign transaction fee should be displayed.

Type: Fee (nested)

Note: If used, must include feeDescription and either feeValuePercent or feeValueAmount (amount + currency). See Nested Field Types below.

introAnnualMemFee

How the introductory annual member fee should be displayed.

Type: Fee (nested)

Note: If used, must include feeDescription and either feeValuePercent or feeValueAmount (amount + currency). See Nested Field Types below.

introAnnualMemFeePeriod

How the introductory annual member fee period should be displayed.

Type: Period (nested)

Note: If used, must include periodDescription, periodValue (numeric), and periodType (Day/Month/Year). See Nested Field Types below.

annualMemFee

How the annual member fee should be displayed.

Type: Fee (nested)

Note: If used, must include feeDescription and either feeValuePercent or feeValueAmount (amount + currency). See Nested Field Types below.

minimumDeposit

How minimum deposit should be displayed.

Type: Numeric

Note: Must be in decimal format.

Categories

Relevant card categories.

Type: String (comma-separated)Format: Max 2000 characters

mobileCopy

How mobile copy should be displayed. Make sure all bullets are HTML encoded.

Type: StringFormat: Max 2000 characters

additionalCopy

How additional copy should be displayed. Make sure all bullets are HTML encoded.

Type: StringFormat: Max 2000 characters

customPromotion

How custom promotion should be displayed.

Type: StringFormat: Max 1000 characters

rewards1

Rewards offered on the card (first reward entry).

Type: Reward (nested)

Note: If used, must include Rate (alphanumeric), Type (max 100 chars), and Terms (max 1000 chars). See Nested Field Types below.

rewards2

Rewards offered on the card (second reward entry).

Type: Reward (nested)

Note: If used, must include Rate (alphanumeric), Type (max 100 chars), and Terms (max 1000 chars). See Nested Field Types below.

rewards3

Rewards offered on the card (third reward entry).

Type: Reward (nested)

Note: If used, must include Rate (alphanumeric), Type (max 100 chars), and Terms (max 1000 chars). See Nested Field Types below.

rewards4

Rewards offered on the card (fourth reward entry).

Type: Reward (nested)

Note: If used, must include Rate (alphanumeric), Type (max 100 chars), and Terms (max 1000 chars). See Nested Field Types below.

rewardsBonus

Numeric value of rewards. If relevant, pair the number with the appropriate symbol ($, %, etc.).

Type: Numeric

Note: Must be in decimal format.

rewardsBonusTerms

Reward bonus terms, must be verbatim.

Type: StringFormat: Max 1000 characters

prohibitedCategories

List of non-approved categories.

Type: String (comma-separated)Format: Max 1000 characters

recommendedSiteType

List of recommended or approved site types.

Type: String (comma-separated)Format: Max 1000 characters

detailsRatesFeesUrl

URL for terms and additional details.

Type: URL

Note: Must be a valid URL starting with http:// or https://.

regularAPR

The regular Annual Percentage Rate details for this product.

Type: APR (nested)

Note: If used, must include aprValue, aprType (Fixed or Variable), and aprDescription. See Nested Field Types below.

introPurchAPR

The introductory purchase Annual Percentage Rate details for this product.

Type: APR (nested)

Note: If used, must include aprValue, aprType (Fixed or Variable), and aprDescription. See Nested Field Types below.

introPurchAPRPeriod

How the introductory purchase APR period should be displayed.

Type: Period (nested)

Note: If used, must include periodDescription, periodValue (numeric), and periodType (Day/Month/Year). See Nested Field Types below.

introTransferAPR

The introductory transfer Annual Percentage Rate details for this product.

Type: APR (nested)

Note: If used, must include aprValue, aprType (Fixed or Variable), and aprDescription. See Nested Field Types below.

introTransferAPRPeriod

How the introductory transfer APR period should be displayed.

Type: Period (nested)

Note: If used, must include periodDescription, periodValue (numeric), and periodType (Day/Month/Year). See Nested Field Types below.

cashGracePeriod

How the cash grace period should be displayed.

Type: Period (nested)

Note: If used, must include periodDescription, periodValue (numeric), and periodType (Day/Month/Year). See Nested Field Types below.

transferGracePeriod

How the transfer grace period should be displayed.

Type: Period (nested)

Note: If used, must include periodDescription, periodValue (numeric), and periodType (Day/Month/Year). See Nested Field Types below.

cardName

The card name.

Type: StringFormat: Max 1000 characters

productType

The financial product type.

Type: StringFormat: Max 1000 characters

language

Language of the product details page the shopper will be directed to. Default is English.

Type: StringFormat: Max 1000 characters

Note: Recommended. Must give the language name.

customField1

Custom field for advertiser-defined data.

Type: CustomField (nested)

Note: If used, must include customFieldName, customFieldType, and customFieldValue. All three sub-attributes are required together. See Nested Field Types below.

customField2

Custom field for advertiser-defined data.

Type: CustomField (nested)

Note: If used, must include customFieldName, customFieldType, and customFieldValue. See Nested Field Types below.

customField3

Custom field for advertiser-defined data.

Type: CustomField (nested)

Note: If used, must include customFieldName, customFieldType, and customFieldValue. See Nested Field Types below.

customField4

Custom field for advertiser-defined data.

Type: CustomField (nested)

Note: If used, must include customFieldName, customFieldType, and customFieldValue. See Nested Field Types below.

customField5

Custom field for advertiser-defined data.

Type: CustomField (nested)

Note: If used, must include customFieldName, customFieldType, and customFieldValue. See Nested Field Types below.

Nested Field Types

Several Finance feed fields use structured nested types rather than simple scalar values. When one of these fields is included in your feed, all required sub-attributes must also be present.

APR

Used by: nonIntroPurchAPR, nonIntroTransAPR, cashAdvanceAPR, penaltyAPR, regularAPR, introPurchAPR, introTransferAPR

Sub-attribute	Description	Format	Required
`aprValue`	Annual Percentage Rate value	Max 1000 chars	Required if any APR sub-attribute is provided
`aprType`	Whether the APR is fixed or variable	`Fixed` or `Variable`	Required if any APR sub-attribute is provided
`aprDescription`	Description of the APR value	Max 1000 chars	Required if any APR sub-attribute is provided

Note: For Fixed APR type, only one value may be provided. For Variable, multiple values are allowed.

Fee

Used by: balanceTransFeeValue, cashAdvanceFee, latePaymentFee, returnPaymentFee, overLimitFee, foreignTransFee, introAnnualMemFee, annualMemFee

Sub-attribute	Description	Format	Required
`feeDescription`	Description of the fee	Max 1000 chars	Required if any Fee sub-attribute is provided
`feeValuePercent`	Percentage of fee being applied	Numeric	Required if `feeValueAmount` is not provided
`feeValueAmount`	Amount of fee (nested: `amount` + `currency`)	See below	Required if `feeValuePercent` is not provided

feeValueAmount sub-attributes:

Sub-attribute	Description	Format	Required
`amount`	Fee amount value	Numeric	Required if using `feeValueAmount`
`currency`	Currency of the fee amount	Max 1000 chars. ISO 4217 currency code	Required if using `feeValueAmount`

Period

Used by: purchGracePeriod, introAnnualMemFeePeriod, introPurchAPRPeriod, introTransferAPRPeriod, cashGracePeriod, transferGracePeriod

Sub-attribute	Description	Format	Required
`periodDescription`	Description of the period value	Max 1000 chars	Required if any Period sub-attribute is provided
`periodValue`	Duration of the period	Numeric	Required if any Period sub-attribute is provided
`periodType`	Type of duration	`Day`, `Month`, or `Year`	Required if any Period sub-attribute is provided

Reward

Used by: rewards1, rewards2, rewards3, rewards4

Sub-attribute	Description	Format	Required
`Rate`	Reward rate (must be verbatim)	Alphanumeric	Required if any Reward sub-attribute is provided
`Type`	Reward type (must be verbatim)	Max 100 chars	Required if any Reward sub-attribute is provided
`Terms`	Terms on which the reward can be redeemed	Max 1000 chars	Required if any Reward sub-attribute is provided

CustomField

Used by: customField1 through customField5

Sub-attribute	Description	Format	Required
`customFieldName`	Name of the custom field	Max 1000 chars	Required if any CustomField sub-attribute is provided
`customFieldType`	Type of the custom field	Max 1000 chars	Required if any CustomField sub-attribute is provided
`customFieldValue`	Value of the custom field	Max 1000 chars	Required if any CustomField sub-attribute is provided

All three sub-attributes must be provided together. You will receive an error if any one is missing.