Fiskil Docs

Create a new product

Create a new banking product with the provided details

POST
/products

Create a new banking product with the provided details

Authorization

bearerAuth
AuthorizationBearer <token>

OAuth 2.0 access token from the token endpoint. See Platform API authentication.

In: header

Request Body

application/json

Product request body

additional_informationproduct.ProductAdditionalInformation
Show 10 child attributes
additional_information.additional_bundle_urisarray<product.ProductAdditionalInformationURI>

Additional links to bundle information if the product is part of a bundle.

Show array item attributes

Description of the additional information URI.

additional_information.additional_eligibility_urisarray<product.ProductAdditionalInformationURI>

Additional links to eligibility criteria for the product.

Show array item attributes
additional_information.additional_fees_and_pricing_urisarray<product.ProductAdditionalInformationURI>

Additional links to fees and pricing information.

Show array item attributes
additional_information.additional_overview_urisarray<product.ProductAdditionalInformationURI>

Additional links to a general overview of the product.

Show array item attributes
additional_information.additional_terms_urisarray<product.ProductAdditionalInformationURI>

Additional links to terms and conditions for the product.

Show array item attributes

Link to bundle information if the product is part of a bundle.

Link to eligibility criteria for the product.

Link to fees and pricing information.

Link to a general overview of the product.

Link to terms and conditions for the product.

A link to an application web page where this product can be applied for

brandstringrequired

Institution brand managing the product.

An optional display name for the brand.

bundlesarray<product.ProductBundle>

Array of bundles that this product is included in

Show array item attributes

Display text providing more information on the bundle

Link to a web page with more information on the bundle criteria and benefits

Description of the bundle.

bundles.namestringrequired

Name of the bundle.

bundles.product_idsarray<string>

List of product IDS for the other products that are included in the bundle and are available via the product API Note that any products not available in the product API should not be included.

card_artarray<product.ProductCardArt>

Array of card art images

Show array item attributes
card_art.card_schemestringrequired
Value in"AMEX" | "EFTPOS" | "MASTERCARD" | "VISA" | "OTHER"
card_art.card_typestringrequired
Value in"CHARGE" | "CREDIT" | "DEBIT"
card_art.image_uristringrequired

URI reference to a PNG, JPG, or GIF image. May be a link or a URL encoded data URI

Display label for the specific image

constraintsarray<product.ProductConstraint>

An array of constraint objects.

Show array item attributes

Additional information about the constraint.

Link to more information about the constraint.

The value of the constraint.

The type of constraint.

Value in"MAX_BALANCE" | "MAX_LIMIT" | "MIN_BALANCE" | "MIN_LIMIT" | "MIN_LVR" | "MAX_LVR" | "OPENING_BALANCE" | "OTHER"
deposit_ratesarray<product.ProductDepositRate>

An array of deposit rates, e.g. interest rates for deposit products.

Show array item attributes

Additional information about the rate.

Link to more information about the rate.

Additional value for the rate, if required by rate type.

deposit_rates.applicability_conditionsarray<product.ProductApplicabilityConditions>

Applicability conditions for the rate.

Show array item attributes

Display text providing more information on the condition.

Link to a web page with more information on this condition.

Generic field containing additional information relevant to the rateApplicabilityType specified.

Category of applicability condition associated with the rate.

Value in"MIN_DEPOSITS" | "MIN_DEPOSIT_AMOUNT" | "DEPOSIT_BALANCE_INCREASED" | "EXISTING_CUST" | "NEW_ACCOUNTS" | "NEW_CUSTOMER" | "NEW_CUSTOMER_TO_GROUP" | "ONLINE_ONLY" | "OTHER" | "MIN_PURCHASES" | "MAX_WITHDRAWALS" | "MAX_WITHDRAWAL_AMOUNT"

How frequently interest is applied.

The type of approach used to apply the rate to the account.

Value in"MATURITY" | "PERIODIC" | "UPFRONT"

How frequently interest is calculated.

The type of deposit rate.

Value in"BONUS" | "BUNDLE_BONUS" | "FIXED" | "FLOATING" | "INTRODUCTORY" | "MARKET_LINKED" | "VARIABLE"
deposit_rates.ratestringrequired

The interest rate.

deposit_rates.tiersarray<product.ProductRateTier>

Rate tiers for tiered interest rates.

Show array item attributes

Display text providing more information on the rate tier.

Link to a web page with more information on this rate tier.

deposit_rates.tiers.applicability_conditionsarray<product.ProductApplicabilityConditions>

Applicability conditions for the rate tier.

Show array item attributes

The number of unitOfMeasure units that form the upper bound of the tier or band.

The number of unitOfMeasure units that form the lower bound of the tier. The tier should be inclusive of this value.

A display name for the tier.

The method used to calculate the amount to be applied using one or more tiers.

Value in"PER_TIER" | "WHOLE_BALANCE"

The unit of measure that applies to the minimumValue and maximumValue values.

Value in"DAY" | "DOLLAR" | "MONTH" | "PERCENT"
descriptionstringrequired

A description of the product suitable for display to customers.

The date and time from which this product is effective. If not present, the product is available immediately.

The date and time at which this product will be retired and no longer available for new applications.

eligibilityarray<product.ProductEligibility>

An array of eligibility criteria objects.

Show array item attributes

Additional information about the eligibility criteria.

Link to more information about eligibility.

Additional value for the criteria, if required by the eligibility type.

The type of eligibility criteria.

Value in"BUSINESS" | "EMPLOYMENT_STATUS" | "MAX_AGE" | "MIN_AGE" | "MIN_INCOME" | "MIN_TURNOVER" | "NATURAL_PERSON" | "OTHER" | "PENSION_RECIPIENT" | "RESIDENCY_STATUS" | "STAFF" | "STUDENT"
featuresarray<product.ProductFeature>

An array of feature objects describing product capabilities.

Show array item attributes

Additional information about the feature.

Link to more information about the feature.

Additional value for the feature, if required by the feature type.

features.feature_typestringrequired

The type of feature. See CDR standard for full list.

Value in"ADDITIONAL_CARDS" | "BALANCE_TRANSFERS" | "BILL_PAYMENT" | "BONUS_REWARDS" | "CARD_ACCESS" | "CASHBACK_OFFER" | "COMPLEMENTARY_PRODUCT_DISCOUNTS" | "DIGITAL_BANKING" | "DIGITAL_WALLET" | "DONATE_INTEREST" | "EXTRA_DOWN_PAYMENT" | "EXTRA_REPAYMENTS" | "FRAUD_PROTECTION" | "FUNDS_AVAILABLE_AFTER" | "FREE_TXNS" | "FREE_TXNS_ALLOWANCE" | "FUNDS_AVAILABLE_AFTER" | "GUARANTOR" | "INSURANCE" | "INSTALMENT_PLAN" | "INTEREST_FREE" | "INTEREST_FREE_TRANSFERS" | "LOYALTY_PROGRAM" | "NOTIFICATIONS" | "NPP_ENABLED" | "NPP_PAYID" | "OFFSET" | "OTHER" | "OVERDRAFT" | "REDRAW" | "RELATIONSHIP_MANAGEMENT" | "UNLIMITED_TXNS"
feesarray<product.ProductFee>

An array of fees associated with the product.

Show array item attributes
fees.discountsarray<product.ProductFeeDiscount>
Show array item attributes

Must be amountstring if discount type is BALANCE, DEPOSIT, or PAYMENTS. If discount type is FEE_CAP must be an iso8601 duration

Value in"fixedAmount" | "rateBased"
Value in"BALANCE" | "DEPOSITS" | "ELIGIBILITY_ONLY" | "FEE_CAP" | "PAYMENTS"
fees.discounts.eligibilityarray<product.ProductFeeDiscountEligibility>
Show array item attributes
Value in"BUSINESS" | "EMPLOYMENT_STATUS" | "INTRODUCTORY" | "MAX_AGE" | "MIN_AGE" | "MIN_INCOME" | "MIN_TURNOVER" | "NATURAL_PERSON" | "OTHER" | "PENSION_RECIPIENT" | "RESIDENCY_STATUS" | "STAFF" | "STUDENT"
fees.discounts.fixed_amountproduct.BankingFeeDiscountFixedAmount
Show 1 child attribute

The specific amount discounted from the fee each time it is incurred

fees.discounts.rate_basedproduct.BankingFeeDiscountRateBased
Show 3 child attributes
fees.discounts.rate_based.amount_rangeproduct.BankingFeeDiscountRange
Show 2 child attributes

The maximum fee discount that will be applied per occurrence

The minimum fee discount that will be applied per occurrence

The rate used to calculate the discount

The property that the fee is based on

  • BALANCE means the fee will be determined based on the current account balance
  • FEE means the discount is based on the fee amount
  • INTEREST ACCRUED means the discount is based on the total interest accrued
  • TRANSACTION means the discount is based on a transaction
Value in"BALANCE" | "FEE" | "INTEREST_ACCRUED" | "TRANSACTION"

The cap amount if multiple occurrences of the fee are capped to a limit

The duration over which multiple occurrences of the fee will be capped, formatted as an ISO8601 duration

The method for defining the fee amount

Value in"fixedAmount" | "rateBased" | "variable"
fees.fee_typestringrequired
Value in"CASH_ADVANCE" | "DEPOSIT" | "DISHONOUR" | "ENQUIRY" | "EVENT" | "EXIT" | "LATE_PAYMENT" | "OTHER" | "PAYMENT" | "PERIODIC" | "PURCHASE" | "REPLACEMENT" | "TRANSACTION" | "UPFRONT" | "UPFRONT_PER_PLAN" | "VARIATION" | "WITHDRAWAL"

A specific amount fee. Required if fee_method_u_type is fixedAmount

Show 1 child attribute
fees.namestringrequired

The fee amount is a rate dependent on something else. Required if fee_method_u_type is rateBased

Show 4 child attributes

The indicative frequency with which the fee is calculated on the account, if applicable

fees.rate_based.amount_rangeproduct.ProductFeeRange
Show 2 child attributes

The maximum fee charged per occurrence

The minimum fee charged per occurrence

fees.rate_based.ratestringrequired

The fee rate

Value that the rate will be applied to.

  • BALANCE means the fee will be determined as a rate of the current account balance
  • INTEREST_ACCRUED means the fee will be determined as a rate of the total interest accrued
  • TRANSACTION means the fee will be determined as a rate of a transaction
Value in"BALANCE" | "INTEREST_ACCRUED" | "TRANSACTION"

The fee amount or rate is unknown until the fee is incurred. Required if fee_method_u_type is variable

Show 2 child attributes
Circular reference
Circular reference

Details of instalment plan features on the account

Show 6 child attributes

Maximum combined limit of all instalment plans that may be created on the account.

Maximum number of concurrent, active instalment plans that may be created on the account. If unset, there is no predetermined maximum number

Range0 <= value

Maximum value that can be opened as an instalment plan. If unset, instalments_limit is assumed to be the maximum individual plan value

Maximum number of instalment payments a plan can be created with

Range1 <= value

Minimum value that can be opened as an instalment plan

Minimum number of instalment payments a plan can be created with

Range1 <= value
is_tailoredbooleanrequired

Indicates whether the product is specifically tailored to a circumstance.

lending_ratesarray<product.ProductLendingRate>

An array of lending rates, e.g. interest rates for lending products.

Show array item attributes

Additional information about the rate.

Link to more information about the rate.

Additional value for the rate, if required by rate type.

lending_rates.applicability_conditionsarray<product.ProductApplicabilityConditions>

Applicability conditions for the rate.

Show array item attributes

How frequently interest is applied.

The type of approach used to apply the rate to the account.

Value in"MATURITY" | "PERIODIC" | "UPFRONT"

How frequently interest is calculated.

The comparison rate for the lending product.

When interest is payable.

Value in"IN_ADVANCE" | "IN_ARREARS"

The type of lending rate.

Value in"BALANCE_TRANSFER" | "BUNDLE_DISCOUNT_FIXED" | "BUNDLE_DISCOUNT_VARIABLE" | "CASH_ADVANCE" | "DISCOUNT" | "FIXED" | "FLOATING" | "INTRODUCTORY" | "MARKET_LINKED" | "PENALTY" | "PURCHASE" | "VARIABLE"

The purpose of the loan.

Value in"INVESTMENT" | "OWNER_OCCUPIED" | "OTHER" | "UNCONSTRAINED"
lending_rates.ratestringrequired

The interest rate.

The repayment type.

Value in"INTEREST_ONLY" | "PRINCIPAL_AND_INTEREST" | "OTHER" | "UNCONSTRAINED"
lending_rates.tiersarray<product.ProductRateTier>

Rate tiers for tiered interest rates.

Show array item attributes
namestringrequired

The display name of the product shown to customers.

product_categorystringrequired

The category of the product as defined by the CDR standard.

Value in"BUSINESS_LOANS" | "BUY_NOW_PAY_LATER" | "CRED_AND_CHRG_CARDS" | "LEASES" | "MARGIN_LOANS" | "OVERDRAFTS" | "PERS_LOANS" | "REGULATED_TRUST_ACCOUNTS" | "RESIDENTIAL_MORTGAGES" | "TERM_DEPOSITS" | "TRADE_FINANCE" | "TRANS_AND_SAVINGS_ACCOUNTS" | "TRAVEL_CARDS"

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/products" \  -H "Content-Type: application/json" \  -d '{    "brand": "string",    "description": "string",    "is_tailored": true,    "name": "string",    "product_category": "BUSINESS_LOANS"  }'
{  "product_id": "string"}
{  "property1": "string",  "property2": "string"}
{  "property1": "string",  "property2": "string"}