Fiserv · Schema

Fiserv Account

Schema representing a financial account across Fiserv banking and card APIs including BankingHub and CardDeveloper.

BankingFinancialPaymentsWealth ManagementFortune 500

Properties

Name	Type	Description
accountId	string	The unique account identifier.
accountNumber	string	The account number.
accountType	string	The type of account.
status	string	The current account status.
partyId	string	The party (customer) identifier who owns the account.
productCode	string	The product code for the account.
branchId	string	The branch identifier where the account is held.
currency	string	The ISO 4217 currency code for the account.
balances	object
limits	object
openDate	string	The date the account was opened.
closeDate	string	The date the account was closed, if applicable.
billingCycleDay	integer	The billing cycle day of the month for credit accounts.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://developer.fiserv.com/schemas/fiserv/account.json",
  "title": "Fiserv Account",
  "description": "Schema representing a financial account across Fiserv banking and card APIs including BankingHub and CardDeveloper.",
  "type": "object",
  "required": ["accountId", "accountType", "status"],
  "properties": {
    "accountId": {
      "type": "string",
      "description": "The unique account identifier."
    },
    "accountNumber": {
      "type": "string",
      "description": "The account number."
    },
    "accountType": {
      "type": "string",
      "enum": ["DDA", "SDA", "MMA", "CDA", "LOAN", "CONSUMER_CREDIT", "COMMERCIAL_CREDIT", "CONSUMER_DEBIT"],
      "description": "The type of account."
    },
    "status": {
      "type": "string",
      "enum": ["ACTIVE", "INACTIVE", "CLOSED", "DORMANT", "FROZEN"],
      "description": "The current account status."
    },
    "partyId": {
      "type": "string",
      "description": "The party (customer) identifier who owns the account."
    },
    "productCode": {
      "type": "string",
      "description": "The product code for the account."
    },
    "branchId": {
      "type": "string",
      "description": "The branch identifier where the account is held."
    },
    "currency": {
      "type": "string",
      "pattern": "^[A-Z]{3}$",
      "description": "The ISO 4217 currency code for the account."
    },
    "balances": {
      "$ref": "#/$defs/Balances"
    },
    "limits": {
      "$ref": "#/$defs/Limits"
    },
    "openDate": {
      "type": "string",
      "format": "date",
      "description": "The date the account was opened."
    },
    "closeDate": {
      "type": "string",
      "format": "date",
      "description": "The date the account was closed, if applicable."
    },
    "billingCycleDay": {
      "type": "integer",
      "minimum": 1,
      "maximum": 28,
      "description": "The billing cycle day of the month for credit accounts."
    }
  },
  "$defs": {
    "Balances": {
      "type": "object",
      "description": "Account balance information.",
      "properties": {
        "available": {
          "type": "number",
          "description": "The available balance or available credit."
        },
        "current": {
          "type": "number",
          "description": "The current (ledger) balance."
        },
        "pending": {
          "type": "number",
          "description": "The pending balance from unposted transactions."
        },
        "creditLimit": {
          "type": "number",
          "description": "The credit limit for credit accounts."
        },
        "minimumPaymentDue": {
          "type": "number",
          "description": "The minimum payment due for credit accounts."
        }
      }
    },
    "Limits": {
      "type": "object",
      "description": "Account limit information for credit and card accounts.",
      "properties": {
        "creditLimit": {
          "type": "number",
          "minimum": 0,
          "description": "The permanent credit limit."
        },
        "temporaryCreditLimit": {
          "type": "number",
          "minimum": 0,
          "description": "The temporary credit limit."
        },
        "temporaryCreditLimitExpiry": {
          "type": "string",
          "format": "date",
          "description": "The expiry date for the temporary credit limit."
        },
        "cashLimit": {
          "type": "number",
          "minimum": 0,
          "description": "The cash advance limit."
        },
        "availableCredit": {
          "type": "number",
          "description": "The available credit amount."
        },
        "availableCash": {
          "type": "number",
          "description": "The available cash advance amount."
        }
      }
    }
  }
}