FIBO schema.org

Introduction

Schema.org is a collaborative, community activity with a mission to create, maintain, and promote schemas for structured data on the Internet, on web pages, in email messages, and beyond. FIBO schema.org hosted extension reuses some of FIBO classes and properties to provide background information on the use of schema.org for marking up banks and their products. For more information and for communication with the community behind the project, please refer to http://schema.org/docs/financial.html and http://w3.org/community/fibo/.

The complete hierarchy of all terms in the FIBO schema.org financial extension

Types:

  • Thing
    • Action
      • TransferAction
        • MoneyTransfer
    • Intangible
      • Service
        • FinancialProduct (in FIBO - FinancialProduct)
          • BankAccount (in FIBO - BankAccount)
            • DepositAccount (in FIBO - DepositAccount)
          • CurrencyConversionService (in FIBO - CurrencyConversionService)
          • InvestmentOrDeposit (in FIBO - InvestmentOrDepositAccount)
            • BrokerageAccount (in FIBO - BrokerageAccount)
            • DepositAccount (in FIBO - DepositAccount)
            • InvestmentFund (in FIBO - InvestmentService)
          • LoanOrCredit (in FIBO - LoanOrCreditAccount)
            • CreditCard (in FIBO - CreditCardProduct)
            • MortgageLoan (in FIBO - LoanMarketCategory-Mortgage)
          • PaymentCard (in FIBO - CardProduct)
            • CreditCard (in FIBO - CreditCardProduct)
          • PaymentService (in FIBO - PaymentService)
        • StructuredValue
          • ExchangeRateSpecification (in FIBO - ExchangeRate)
          • MonetaryAmount (in FIBO - MonetaryAmount)
          • RepaymentSpecification (in FIBO - PrincipalRepaymentTerms)

MoneyTransfer, FinancialProduct and all its subtypes, and all subtypes of StructuredValue are the FIBO schema.org extension terms. The other terms have already been defined in the schema.org.

Properties: All properties below except identifier and duration are the FIBO schema.org extension terms.

  • Thing
    • Property
      • annualPercentageRate
      • feesAndCommissionsSpecification
      • interestRate
      • identifier
        • leiCode
      • duration
        • loanTerm
      • requiredCollateral
      • accountMinimumInflow
      • accountOverdraftLimit
      • amount
      • bankAccountType
      • beneficiaryBank
      • cashBack
      • contactlessPayment
      • currency
      • currentExchangeRate
      • domiciledMortgage
      • downPayment
      • earlyPrepaymentPenalty
      • exchangeRate
      • exchangeRateSpread
      • floorLimit
      • gracePeriod
      • loanMortgageMandateAmount
      • loanPaymentAmount
      • loanPaymentFrequency
      • loanRepaymentForm
      • loanType
      • monthlyMinimumRepaymentAmount
      • numberOfLoanPayments
      • recourseLoan
      • renegotiableLoan

An example of diagram for MortgageLoan type

In this example, the MortgageLoan (sub-class of the sequence of LoanOrCredit -> FinancialProduct) is described through the following properties: amount, interestRate, annualPercentageRate (representing APR), loanTerm and loanRepaymentForm.

Visit http://schema.org/docs/financial.html for more examples.

CreditCard - markup example

Below we present an example of the use of the schema.org mark-up in the HTML pages.

CreditCard

This example illustrates the use of FIBO schema.org financial extension for the description of credit cards. The specific card being described is identified by its name (name). The details of the offer presented by the card are expressed through: annualPercentageRate, interestRate, a percentage of "cashback" (if applicable), the card grace period (gracePeriod) and the flag for the contactless payments (contactlessPayment). The additional properties, like offeredBy allow indicating the issuer of the card and annual cardholder’s cost of the card (price) – further detailed by its currency (currency) and type ("@type").

Without markup Wells Fargo Secured Visa® Credit Card Requires a minimum $300 security deposit. When you apply, you provide a minimum security deposit of at least $300, or up to $10,000. Annual fee $25 Annual Percentage Rate (APR) Currently, a variable 18.99% APR on purchases. (These APRs do not apply to cash advances.) Full terms and conditions

Microdata

<div itemscope itemtype="http://schema.org/CreditCard">
    <span itemprop="name">Wells Fargo Secured Visa® Credit Card</span>
    <span itemprop="requiredCollateral">Requires a minimum $300 security deposit.</span>
    <span itemprop="amount" itemscope itemtype="http://schema.org/MonetaryAmount">When you apply, you provide a minimum security deposit of at least
      <span itemprop="currency" content="USD">$</span>
      <span itemprop="minValue">300</span>, or up to $
      <span itemprop="maxValue" content="10000">10,000</span>.
    </span>
    <span itemprop="offers" itemscope itemtype="http://schema.org/Offer">
      <meta itemprop="offeredBy" content="Wells Fargo"/>
      <span itemprop="priceSpecification" itemscope itemtype="http://schema.org/UnitPriceSpecification">Annual fee
        <span itemprop="priceCurrency" content="USD">$</span>
        <span itemprop="price">25</span>
        <span itemprop="referenceQuantity" itemscope itemtype="http://schema.org/QuantitativeValue">
            <meta itemprop="value" content="1"/><meta itemprop="unitCode" content="ANN"/>
        </span>
      </span>
    </span>
    <span>Annual Percentage Rate (APR) Currently, a variable
      <span itemprop="annualPercentageRate">18.99</span>% APR on purchases. (These APRs do not apply to cash advances.)
    </span>
    <a itemprop="feesAndCommissionsSpecification" href="https://www.wellsfargo.com/credit-cards/secured/terms/">Full terms and conditions</a>
</div>

RDFa

<div vocab="http://schema.org/" typeof="CreditCard">
    <span property="name">Wells Fargo Secured Visa® Credit Card</span>
    <span property="requiredCollateral">Requires a minimum $300 security deposit.</span>
    <span property="amount" typeof="MonetaryAmount">When you apply, you provide a minimum security deposit of at least
      <span property="currency" content="USD">$</span>
      <span property="minValue">300</span>, or up to $
      <span property="maxValue" content="10000">10,000</span>.
    </span>
    <span property="offers" typeof="Offer">
      <meta property="offeredBy" content="Wells Fargo"/>
      <span property="priceSpecification" typeof="UnitPriceSpecification">Annual fee
        <span property="priceCurrency" content="USD">$</span>
        <span property="price">25</span>
        <span property="referenceQuantity" typeof="QuantitativeValue">
            <meta property="value" content="1"/>
            <meta property="unitCode" content="ANN"/>
        </span>
      </span>
    </span>
    <span>Annual Percentage Rate (APR) Currently, a variable
      <span property="annualPercentageRate">18.99</span>% APR on purchases. (These APRs do not apply to cash advances.)
    </span>
    <a property="feesAndCommissionsSpecification" href="https://www.wellsfargo.com/credit-cards/secured/terms/">Full terms and conditions</a>
</div>

JSON-LD

<script type="application/ld+json">
{
{
  "@context": "http://schema.org",
  "@type": "CreditCard",
  "name": "Wells Fargo Secured Visa® Credit Card",
  "requiredCollateral": "Requires a minimum $300 security deposit.",
  "amount": {
      "@type": "MonetaryAmount",
      "minValue": "300",
      "maxValue": "10000",
      "currency": "USD"
  },
  "offers": {
      "@type": "Offer",
      "offeredBy": {
        "@type": "BankOrCreditUnion",
        "name":"Wells Fargo"
      },
      "priceSpecification": {
        "@type": "UnitPriceSpecification",
        "price": "25",
        "priceCurrency": "USD",
        "referenceQuantity": {
          "@type": "QuantitativeValue",
          "value": "1",
          "unitCode": "ANN"
        }
      }
  },
  "annualPercentageRate": "18.99",
  "feesAndCommissionsSpecification": "https://www.wellsfargo.com/credit-cards/secured/terms/"
}
</script>