Industry Vocabulary Reference
Banking & Financial Services
Banking and financial services field names and values for recorded workflows. The catalog includes payments, lending, fraud, treasury, customer lifecycle, model risk, regulatory capital, and digital assets. Use these values in OTel span attributes and mapped policy inputs; they do not establish regulatory compliance.
Back to industry coverage library
This page shows selected examples and categories. Download the JSON for the complete vocabulary, including every field, permitted value, and policy pattern in this catalog.
How to use this reference
- Start with the core file if you need the cross-industry governance baseline.
- Choose an industry file for its workflow fields and permitted values.
- Match the OTel attributes to the policy paths your rules use, then verify the recorded fields in a test session.
Catalog context
Use this vocabulary to describe workflows such as payment fraud screening, loan underwriting, customer onboarding, and model validation. Select fields that your integration can report reliably. Your compliance team must determine which requirements apply; recording a field does not satisfy those requirements.
Vocabulary file
- Download filename: 01_vertical_banking_financial_services.json
- Kind: vertical
OTel namespaces
Referenced standards
These references explain the catalog's context. A listed standard does not establish that a configured application meets its requirements.
- BIAN v13 / v14 (Banking Industry Architecture Network)
- ISO 20022, Universal financial industry message scheme
- Basel III, BCBS finalisation framework; implementation varies by jurisdiction
- EU DORA, Digital Operational Resilience Act (2022/2554, effective Jan 2025)
- FATF Recommendations, AML/CFT (updated 2023)
- EU 6AMLD, Sixth Anti-Money Laundering Directive
- FinCEN / BSA, Bank Secrecy Act SAR requirements
- PCI DSS v4.0, Payment Card Industry Data Security Standard
- SWIFT CBPR+, Cross-Border Payments and Reporting Plus (coexistence ended Nov 2025)
- FedNow, Federal Reserve real-time payment service ISO 20022 profile
- SEPA, Single Euro Payments Area rulebooks
Source references
- https://bian.org/deliverables/bian-standards/
- https://www.iso20022.org/iso-20022-message-definitions
- https://www.bis.org/bcbs/publ/d424_hlsummary.pdf
- https://www.eba.europa.eu/regulation-and-policy/operational-resilience/digital-operational-resilience-act-dora
- https://explore.fednow.org/resources/readiness-guide-iso-20022.pdf
- https://www.swift.com/standards/iso-20022/iso-20022-financial-institutions-focus-payments-instructions
Subdomains
| Subdomain | Categories | Sample attributes |
|---|---|---|
| Payments & Funds Transfer | 6 | banking.payment.iso20022_status, banking.payment.message_type, banking.payment.rail |
| Fraud Detection & Financial Crime | 7 | banking.fraud.model_type, banking.fraud.alert_disposition, banking.fraud.case_resolution_state |
| Lending & Credit | 6 | banking.loan.application_status, banking.credit.decision_type, banking.credit.adverse_action_reason |
| Treasury, Capital Markets & Liquidity | 5 | banking.treasury.liquidity_action, banking.capital.ratio_type, banking.capital.rwa_approach |
| Customer Lifecycle & Onboarding | 3 | banking.onboarding.stage, banking.customer.risk_category, banking.customer.consent_type |
| Model Risk Management | 3 | banking.model_risk.validation_status, banking.model_risk.change_type, banking.model_risk.inventory_status |
| Regulatory Reporting & Compliance | 4 | banking.regulatory_report.type, banking.regulatory_report.status, banking.dora.incident_classification |
| Digital Assets & Crypto | 2 | banking.digital_asset.type, banking.vasp.compliance_status |
Implementation examples
- Payments & Funds Transfer: Payment Rail Type. OPA rule: require enhanced OFAC/sanctions screening for swift_cbpr_plus, sepa_credit_transfer, and sepa_instant rails. Require 24/7 HITL coverage for fednow and rtp_tcf rails above configurable threshold. (Fednow: Federal Reserve FedNow Service Operating Procedures)
- Payments & Funds Transfer: Payment Agent Action Type. OPA rule: classify initiate_credit_transfer, initiate_direct_debit, and apply_fx_conversion as irreversible_high_impact, requiring HITL approval above configurable amount threshold. (Psd2: PSD2 Article 64, Liability for unauthorized payment transactions)
- Payments & Funds Transfer: Sanctions Screening Outcome. OPA rule: deny any payment agent tool call for payment rail execution when sanctions_screening_outcome is potential_hit or confirmed_hit; require HITL escalation. (Ofac: OFAC 31 CFR Part 501, Reporting and procedures for blocked transactions)
- Fraud Detection & Financial Crime: AMLAlert Status. OPA rule: require HITL with compliance_officer role for sar_decision_pending state. Block automated sar_filed or sar_declined_documented transitions, these must be human-authorised. (Bsa 31 Usc 5318: BSA 31 USC 5318(g), Suspicious Activity Report filing obligation)
Control ideas
These patterns describe possible controls, not active rules. Confirm applicability, implement the control, and test its effect on the application.
Stop payments flagged by sanctions screening
Block any autonomous payment agent from executing a payment rail tool call when the sanctions screening result is a hit or potential hit. Escalate to compliance immediately.
Regulatory basis: OFAC 31 CFR Part 501; FATF Recommendation 6; PSD2 Article 64
Require human review for SAR filing decision
Ensure that SAR filing or SAR declination decisions are never made autonomously by an AI agent without a compliance officer review and sign-off.
Regulatory basis: BSA 31 USC 5318(g); FinCEN SAR Instructions; 6AMLD Article 33
Enforce before the action
Pass the request and your business action to this function. The core SDK checks policy before the action runs and again before its result is released. A deny or review decision means the action never runs.
import { Veriproof } from '@veriproof/sdk-core';
import type { GovernedResult, IndustryFact, JsonValue } from '@veriproof/sdk-core';
const veriproof = Veriproof.fromEnv();
export async function runProtectedAction<TInput extends JsonValue, TValue>(
request: TInput,
action: (input: TInput, signal: AbortSignal) => Promise<TValue>,
): Promise<GovernedResult<TValue, TInput>> {
// Catalog values for this vertical. Replace them with facts from the current workflow.
const industry: IndustryFact[] = [
{ attribute: "banking.payment.rail", policyInput: "banking_payment_rail", value: "fednow" },
{ attribute: "banking.payment.agent_action", policyInput: "banking_payment_agent_action", value: "initiate_credit_transfer" },
{ attribute: "banking.sanctions.screening_outcome", policyInput: "banking_sanctions_screening_outcome", value: "clear" },
];
// Policy runs before action() and again before the result is released.
// A deny or review decision means action() never runs.
return veriproof.govern(
"banking.financial.services.evaluate",
request,
({ input, signal }) => action(input, signal),
{ industry },
);
}- Replace the sample values with facts from the current workflow. Rules read them under
input.snapshot.industry. - Test both permitted and blocked actions. Confirm that a blocked action never reaches your business function.
- Only
completed,completed_with_warning, andtransformedresults carry a released value.
For review decisions, follow the Human Review guide to configure continuation. Observe remains available when you need to record activity without enforcing a decision.
Set up the Banking & Financial Services example. See the API reference for TypeScript, Python, or .NET.
Try a simulator to see a governed decision in context. To connect your own workflow, verify your work email and start Developer free for 60 days. You can also review the relevant controls with our team.
Live demo → Start free for 60 days → Request coverage workshop →
Selected vocabulary categories
PaymentStatusISO20022
Official ISO 20022 four-letter machine-readable payment status codes from pain.002 CustomerPaymentStatusReport and pacs.002 FIToFIPaymentStatusReport. Use these exact codes when interfacing with clearing systems. Do NOT substitute descriptive strings.
Workflow area: Payments & Funds Transfer
- OTel attribute
banking.payment.iso20022_status- First 8 permitted values
ACTCACCPACSPACSCACWCACWPRCVDPDNG
PaymentMessageType
ISO 20022 message type identifiers for payment-related messages. Tag agent spans with the specific message type being processed to enable per-message-type compliance policy enforcement.
Workflow area: Payments & Funds Transfer
- OTel attribute
banking.payment.message_type- First 8 permitted values
pain.001pain.002pain.008pain.013pain.014pacs.002pacs.003pacs.004
PaymentRailType
The payment clearing and settlement network used for a transaction. Different rails carry different compliance obligations and SLA requirements for autonomous agent processing.
Workflow area: Payments & Funds Transfer
- OTel attribute
banking.payment.rail- First 8 permitted values
fednowach_creditach_debitsame_day_achchapsfedwirechipsswift_cbpr_plus
PaymentPurposeCode
ISO 20022 ExternalPurpose1Code, structured purpose codes mandatory for CHAPS FI-to-FI payments from May 2025 and recommended for all cross-border payments. Agentic payment initiation agents must select the correct code for straight-through processing.
Workflow area: Payments & Funds Transfer
- OTel attribute
banking.payment.purpose_code- First 8 permitted values
BEXPCASHCBLKCCRDCDBLCORTDCRDDIVI
PaymentAgentActionType
The specific action an autonomous payment agent is executing. Used to gate actions behind appropriate controls, autonomous payment initiation is irreversible and requires HITL for amounts above threshold.
Workflow area: Payments & Funds Transfer
- OTel attribute
banking.payment.agent_action- First 8 permitted values
initiate_credit_transferinitiate_direct_debitrequest_payment_cancellationrequest_returnrequest_reversalrequest_status_updateapply_payment_preferenceroute_payment
SanctionsScreeningOutcome
Outcome of OFAC/sanctions list screening for payment parties or account holders. Agentic payment agents must never proceed past a hit or potential_hit without human review.
Workflow area: Payments & Funds Transfer
- OTel attribute
banking.sanctions.screening_outcome- Permitted values
clearpotential_hitconfirmed_hitfalse_positive_cleareddeferred_for_reviewblockedescalated_to_compliance
FraudDetectionModelType
The type of fraud detection model whose inference result is being applied by the agentic system.
Workflow area: Fraud Detection & Financial Crime
- OTel attribute
banking.fraud.model_type- First 8 permitted values
rules_based_engineml_supervised_classifierml_unsupervised_anomalygraph_network_analysisbehavioral_biometricsdevice_fingerprintingllm_narrative_analysisensemble_hybrid
FraudAlertDisposition
The disposition of a fraud alert after review. Record the reported outcome so reviewers can follow the case and assess model performance.
Workflow area: Fraud Detection & Financial Crime
- OTel attribute
banking.fraud.alert_disposition- First 8 permitted values
true_positive_fraud_confirmedfalse_positive_clearedsuspected_fraud_monitoringtransaction_blockedtransaction_reversedcustomer_contactedaccount_restrictedaccount_closed
FraudCaseResolutionState
Defines the allowed values for Fraud Case Resolution State in the Banking & Financial Services catalog so OpenTelemetry spans and OPA policy inputs remain consistent across VeriProof. Terminology aligns to BIAN Fraud Resolution Service Domain.
Workflow area: Fraud Detection & Financial Crime
- OTel attribute
banking.fraud.case_resolution_state- First 8 permitted values
initiateddocumentation_requestedinvestigation_in_progresscustomer_liability_assessedbank_liability_assessedreversal_processedchargeback_filedarbitration_requested
AMLAlertStatus
Defines the allowed values for AML Alert Status in the Banking & Financial Services catalog so OpenTelemetry spans and OPA policy inputs remain consistent across VeriProof. Terminology aligns to FinCEN SAR filing requirements; BIAN Suspicious Transaction Analysis Service Domain; 6AMLD.
Workflow area: Fraud Detection & Financial Crime
- OTel attribute
banking.aml.alert_status- First 8 permitted values
system_generatedunder_reviewescalated_to_l2_analystescalated_to_compliance_officersar_decision_pendingsar_filedsar_declined_documentedclosed_false_positive
AMLTypologyCode
FATF and FinCEN recognised money laundering and terrorist financing typologies. Agent-generated AML alerts should be tagged with the suspected typology to route to the correct specialist.
Workflow area: Fraud Detection & Financial Crime
- OTel attribute
banking.aml.typology- First 8 permitted values
structuring_smurfinglayering_wire_transferstrade_based_money_launderingreal_estate_placementshell_company_layeringcrypto_mixing_tumblinghawala_informal_value_transferloan_back
KYCVerificationStatus
Defines the allowed values for KYC Verification Status in the Banking & Financial Services catalog so OpenTelemetry spans and OPA policy inputs remain consistent across VeriProof. Terminology aligns to BIAN Party Lifecycle Management Service Domain; FATF Recommendations.
Workflow area: Fraud Detection & Financial Crime
- OTel attribute
banking.kyc.status- First 8 permitted values
unverifiedpending_documentationidentity_check_in_progressdocument_verification_in_progressbiometric_check_in_progressverified_standardverified_enhanced_due_diligencerejected
This page uses the vocabulary JSON distributed with the documentation. Check its version when comparing it with an installed SDK.
Download the vocabulary JSON for offline review or automated comparisons.
Use the SDK reference for configuration and supported APIs. Keep vocabulary selection separate from the compliance team's assessment of applicable requirements.