Statements

A statement is an official summary of financial transactions that occurred within a given period for a bank account held by a person or business. Statements are commonly used by account holders to monitor cash flow, check for possible fraudulent transactions, and perform bank reconciliations. Most Galileo clients deliver statements electronically, with some offering a paper option. Issuers in the United States are typically required to send a statement for an account only if one transaction has been made on the account during the statement period.

What's in a statement?

Because a statement is a report of account activity, statements should display activity summaries (debits, credits, fees) as well the details of each transaction that took place during the statement period. Statements should also display the account balance as of the statement date, fee totals, and any interest with the interest rate.

Statement options

As a Galileo client you have these options to provide statements:

• Create statements from the RDFs — Use this option if you want to customize your statements beyond what Galileo offers or to provide statements for credit accounts. See Creating Statements from the RDFs for guidelines.
• Obtain JSON statement data from Galileo — Use this option if you want to create basic statements for debit accounts using JSON files. Continue reading for instructions.

Obtaining statements from Galileo

Galileo currently offers statement data for these account types:

• DDA plus overdraft
• Savings
• GPR

If account holders have all three account types, for example, then Galileo would generate three statements per month for them.

Keep the following in mind:

• Amounts shown are always in the currency in which the account is based, not the currency at the point of sale.
• Statement periods begin at midnight on the first day of the statement cycle and end at 23:59:59 on the last day according to Galileo system time.
• Galileo stores your statement data for two years.
• An account must be in status: N for Galileo to generate a statement for it.

Retrieving statements on-demand

You can retrieve individual account statement data in your interface by calling Get Access Token and then assembling an HTTP call.

Get Access Token call

These parameters are required for the Get Access Token call:

• accountNo — Use the PRN of the account.
• type — Pass 1 (account)

Galileo returns these values:

• token — A case-sensitive alphanumeric string, for example, hpSVyayQScHmhJS6_MVXT1WlsFRQoDJrRu_fi_JlX2Jo2dgg5p
• expires — The date/time the token expires, formatted as YYYY-MM-DD hh:mm:ss The default expiry is 300 seconds and/or 3 attempts. You can change default token-expiry parameters with the TSECV and TUSEC product parameters.

HTTP request for the statement

With the token assemble an HTTP call to retrieve the statement data, as shown in the example. The URL in the example is for an AWS instance that Galileo provisions for each client. If you do not already have an AWS URL, request one from Galileo This example is for the CV environment. For Production change the cv in the URL to pd.

https://asset-[clientname].cv.gpsrv.com/asset/statement/account?token=[token]&config=[config]&date=[mmyy]&statementType=[type]&output=json

where:

• clientname — The name of your tenanted AWS instance
• token — The token returned by Get Access Token
• config — A value provided by Galileo
• date — Statement date in MMYY format. The month corresponds to the first day of the statement period.
• statementType — Type of statement to return:
  • G — GPR
  • D — DDA, including overdraft
  • S — Savings
• output — json

Example HTTP call

https://asset-clientname.cv.gpsrv.com/asset/statement/account?token=qXWUhQL8zwi3uJTykXuInGw7JbVoGf30bhPMNJLlc_nZekwvAQ&config=test&date=0118&statementType=G&output=json

Galileo returns a JSON of the statement data, which you can present electronically or merge into a PDF template. You can print the PDFs on paper for those account holders who have opted out of electronic statements.

Each JSON file name has this format, stmt_PRN_mmyy[_esign].json, where:

• PRN — The account's payment reference number
• mmyy — The month and year of the starting date of the statement
• _esign — Appended when the account holder has opted in to electronic statements

JSON fields

The JSON file that Galileo returns for each statement contains a subset of the fields in the table below. Most of the data are formatted as strings (enclosed in double quotation marks), and within those strings are these data types:

• alphanumeric — A–Z, a–z, and 0–9
• $decimal – $999999999.99. Up to nine digits plus two decimal places and a dollar sign, making 11 digits total. Specified as (11, 2). No comma separation for thousands. $1000 is formatted as $1000.00 instead of $1,000.00, and a negative value is -$1000.00.
• float — Decimal number without a dollar sign.
• integer — Whole number with no decimal.
• list — Nested JSON list.
  long date — A date with the month spelled out and the four-digit year: November 01, 2023 or November 2023.

transactions fields

These fields are nested in the transactions object for each transaction, when transactions are present.

Example JSON statements

Debit account statement

{
  "acct_no": "777777777777",
  "addr1": "70359 Forest Ave",
  "addr2": "Apt 472",
  "adjustments": "152.34",
  "begin_balance": "831.12",
  "begin_date": "November 01, 2023",
  "city": "BUNKER HILL",
  "deposits": "4350.12",
  "end_balance": "4719.03",
  "end_date": "November 30, 2023",
  "fees": "-3.43",
  "fullname": "Katie Carrillo",
  "mmyy": "1123",
  "month_year": "November 2023",
  "prn": "777777777777",
  "prog_name": "Balance Financial by Galileo",
  "purchases": "-442.34",
  "state": "MA",
  "transactions": [
    {
      "amt": "-442.34",
      "trans_desc": "All Terrain Vehicles, Inc. Boston, MA",
      "trans_dt": "11/01/2023",
      "trans_type": "Visa settle"    
},
    {
      "amt": "4350.12",
      "trans_desc": "Payroll Deposit",
      "trans_dt": "11/02/2023",
      "trans_type": "Payment"    
},
    {
      "amt": "-3.43",
      "trans_desc": "Card-to-card fee",
      "trans_dt": "11/03/2023",
      "trans_type": "Fee"    
},
    {
      "amt": "-168.78",
      "trans_desc": "ATM Withdrawal, LEXINGTON, MA US",
      "trans_dt": "11/03/2023",
      "trans_type": "Visa settle"
    },
    {
      "amt": "152.34",
      "trans_desc": "Loyalty Program Cashback",
      "trans_dt": "11/04/2023",
      "trans_type": "Adjustment"
    }
  ],
  "transfers": "0.00",
  "withdrawals": "-168.78",
  "ytd_fees": "3.43",
  "zip": "02056"
}

Savings account statement

{
  "acct_no": "555555555555",
  "addr1": "",
  "addr2": "",
  "apy_period": "2.03",
  "bal_id": 202155,
  "begin_balance": "$20.03",
  "begin_date": "January 01, 2024",
  "business_name": null,
  "cancel_date": null,
  "city": "",
  "deposits": "$1113.03",
  "end_balance": "$615.06",
  "end_date": "January 31, 2024",
  "fullname": "Ezio Calabria",
  "has_interest": true,
  "interest_accrued": "$0.25",
  "interest_paid": "$0.03",
  "is_business_prod": "N",
  "mmyy": "0124",
  "month_year": "January 2024",
  "per_beg_dt": "2024-01-01T00:00:00",
  "per_end_dt": "2024-01-31T23:59:59",
  "period_fees": "$0.00",
  "prn": "555555555555",
  "prod_id": 3091,
  "prog_name": "Goalsetter Banking",
  "purchases": "$518.00",
  "savid": "2.01",
  "savir": "2.00",
  "start_balance": "$20.03",
  "state": "",
  "statement_title": "Savings Statement Title",
  "stmt_type": "S",
  "suppress_od": true,
  "transactions": [
    {
      "act_type": "PM",
      "amt": "$0.03",
      "otrans_dt": "2024-01-01T00:00:00",
      "otype": "MZ",
      "running_balance": "$20.06",
      "source_id": 143700,
      "trans_desc": "Interest Posting",
      "trans_dt": "01/01/2024"
    },
    {
      "act_type": "AD",
      "amt": "-$5.00",
      "otrans_dt": "2024-01-03T00:00:00",
      "otype": "M",
      "running_balance": "$15.06",
      "source_id": 140783,
      "trans_desc": "Transfer ",
      "trans_dt": "01/03/2024"
    },
    {
      "act_type": "PM",
      "amt": "$600.00",
      "otrans_dt": "2024-01-03T00:00:00",
      "otype": "RL",
      "running_balance": "$615.06",
      "source_id": 156056,
      "trans_desc": "Retail Load",
      "trans_dt": "01/03/2024"
    },
    {
      "act_type": "AD",
      "amt": "-$513.00",
      "otrans_dt": "2024-01-03T00:00:00",
      "otype": "M",
      "running_balance": "$102.06",
      "source_id": 140784,
      "trans_desc": "Transfer",
      "trans_dt": "01/03/2024"
    },
    {
      "act_type": "PM",
      "amt": "$513.00",
      "otrans_dt": "2024-01-05T00:00:00",
      "otype": "C2",
      "running_balance": "$615.06",
      "source_id": 157673,
      "trans_desc": "Account-to-Account Transfer",
      "trans_dt": "01/05/2024"
    }
  ],
  "ytd_fees": "$0.00",
  "zip": ""
}

Converting JSONs to PDFs

One way to convert JSON data to PDFs is to follow these steps:

1. Convert the JSON into a format that can be used by an HTML Jinja template.
2. Convert the Jinja template into raw HTML.
3. Use a third-party tool to convert the HTML to PDF.

You may find other ways to port JSON data to a PDF template as suits your use case.

📘

Note

You must ensure that the JSON-to-PDF conversion includes the following elements: header, footer, and legal disclaimers.