Skip to main content

Transactions

The transactions entity contains all monetary activity across accounts.

Overview​

Transactions include:

  • Deposits and withdrawals
  • Transfers (internal and external)
  • Wire transfers (domestic and international)
  • Card transactions (debit, credit, ATM)
  • Checks and ACH
  • Cash activity

Entity Relationships​

Every transaction links to an account via account_number.

Key Fields​

FieldDescriptionExample
account_numberAccount identifier1234567890
dateTransaction date2024-01-15
amountAmount in cents50000 = $500.00
debit_creditDirectionD (debit) or C (credit)
rs_transaction_typeStandardized typeWire, ACH, Cash

Transaction Types​

RiskScout standardizes transaction codes into categories for consistent monitoring:

CategoryDescription
WireWire transfers
International WireCross-border wire transfers
ACHAutomated clearing house
CheckCheck transactions
CashCash deposits/withdrawals
Debit CardDebit card purchases
Internal Financial Institution TransferInternal transfers
External Financial Institution TransferExternal transfers

See Transaction Types for the complete list.

Amount Fields​

Currency Values

All amounts are in cents. $500.00 = 50000

FieldDescription
amountTransaction amount
cash_in_amountCash portion deposited
cash_out_amountCash portion withdrawn

For split transactions, cash_in_amount + cash_out_amount may differ from amount.

Direction Indicator​

ValueMeaning
DDebit - money leaving the account
CCredit - money entering the account

Wire Transfer Fields​

For wire transfers, include:

FieldDescription
wire_dateWire execution date
receiver_nameBeneficiary name
receiver_addressBeneficiary address
receiver_financial_institution_nameReceiving bank
sender_nameOriginator name
sender_addressOriginator address
sender_financial_institution_nameSending bank
international_flagtrue for international

ACH Fields​

For ACH transactions:

FieldDescription
sec_codeSEC code (PPD, CCD, WEB, etc.)
company_nameOriginator company
company_idCompany identifier
individual_nameIndividual name
entry_classEntry class code

Check Fields​

For check transactions:

FieldDescription
check_numberCheck serial number

Cash Transaction Fields​

For cash activity:

FieldDescription
cash_in_amountCash deposited
cash_out_amountCash withdrawn
conductor_namePerson conducting transaction
conductor_idConductor identification
conductor_id_typeType of ID presented

Required Fields​

At minimum, include:

  • account_number - Account reference
  • date - Transaction date
  • amount - Transaction amount
  • debit_credit - Direction
  • code or rs_transaction_type - Transaction type

Recommended:

  • timestamp - Full datetime if available
  • description - Transaction description
  • Channel-specific fields (wire details, ACH info, etc.)

Best Practices​

  1. Daily submission - Transaction data should be submitted daily
  2. Include all activity - Don't filter transactions; RiskScout handles relevance
  3. Consistent coding - Map codes to rs_transaction_type values
  4. Full wire details - Include complete originator/beneficiary info
  5. Cash reporting - Include conductor info for teller transactions

Field Reference​

See Transactions Field Reference for the complete field list with types and descriptions.