Industry Vocabulary Reference
Banking & Financial Services
Comprehensive enumeration library for the Banking and Financial Services vertical. Covers every subdomain where agentic AI is actively deployed as of March 2026: payments, lending, fraud and financial crime, treasury and capital markets, customer lifecycle, model risk, regulatory capital, and digital assets. Designed for use as OTel span attributes in an agentic AI SDK and as policy vocabulary in an OPA Rego GRC portal.
Back to industry coverage library
How to use this reference
- Start with the core file if you need the cross-industry governance baseline.
- Then move into the vertical file to see the regulated workflow vocabulary, policy surfaces, and implementation pressure unique to this market.
- Use the OTel attributes and policy paths here as the common language across SDK instrumentation, governance review, and evidence export.
March 2026 deployment context
As of March 2026, agentic AI in banking is deployed across: real-time payment fraud scoring, autonomous AML alert triage, AI-assisted loan underwriting, autonomous treasury liquidity management, customer onboarding KYC/KYB automation, AI-driven trade surveillance, autonomous regulatory report generation (DORA, Basel, HMDA), and AI-assisted credit risk model validation. Each subdomain carries distinct regulatory obligations that must be traceable through OTel spans to OPA policy decisions.
Loading Model
- Mirrored file: 01_vertical_banking_financial_services.json
- Kind: vertical
OTel Namespaces
Primary Standards
- BIAN v13 / v14 (Banking Industry Architecture Network)
- ISO 20022 — Universal financial industry message scheme
- Basel III / Basel III Endgame (BCBS 2017 finalisation, US phase-in through 2028)
- EU DORA — Digital Operational Resilience Act (2022/2554, effective Jan 2025)
- Federal Reserve SR 11-7 — Supervisory Guidance on Model Risk Management (2011)
- 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 URLs
- 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://www.federalreserve.gov/supervisionreg/srletters/sr1107.htm
- 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)
Illustrative policy patterns
block payment on sanctions hit
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
package banking.payments
blocking_sanctions_outcomes := {"potential_hit", "confirmed_hit", "escalated_to_compliance"}
deny[msg] {
input.banking_payment_agent_action in {
"initiate_credit_transfer",
"initiate_direct_debit",
"apply_fx_conversion"
}
input.banking_sanctions_screening_outcome in blocking_sanctions_outcomes
msg := sprintf("Payment blocked: sanctions screening outcome '%v' requires compliance officer review before execution", [input.banking_sanctions_screening_outcome])
}require hitl 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
package banking.aml
reserved_aml_decisions := {"sar_filed", "sar_declined_documented", "blocked_and_frozen"}
deny[msg] {
input.banking_aml_alert_status in reserved_aml_decisions
input.gen_ai_agent_autonomy_level in {"supervised_autonomous", "fully_autonomous"}
input.gen_ai_hitl_decision != "approved"
msg := "SAR filing and SAR declination decisions require documented compliance officer approval per BSA 31 USC 5318(g)"
}From enum to evidence
The same vocabulary should carry from instrumentation through review. The OTel attribute names here become emitted metadata, those attributes become policy inputs, and those same labels should still be intelligible when a reviewer opens the decision record later.
import { VeriproofClient, VeriproofSdkOptions, SessionMetadata } from '@veriproof/sdk-core';
import { PaymentStatusISO20022, PaymentStatusISO20022Meta, PaymentMessageType, PaymentMessageTypeMeta, PaymentRailType, PaymentRailTypeMeta } from '@veriproof/sdk-core/verticals/banking-financial-services';
const client = new VeriproofClient(
VeriproofSdkOptions.createProduction({
apiKey: process.env.VERIPROOF_API_KEY!,
applicationId: 'banking-financial-services-production',
}),
);
const session = client
.startSession('banking-financial-services.review')
.withSessionMetadata(SessionMetadata.forTransaction('txn-1001').withEnvironment('production'))
.addStep('evaluate_workflow', { output: { status: 'completed' } })
.withMetadata(PaymentStatusISO20022Meta.otelAttribute, PaymentStatusISO20022.ACTC)
.withMetadata(PaymentMessageTypeMeta.otelAttribute, PaymentMessageType.pain.001)
.withMetadata(PaymentRailTypeMeta.otelAttribute, PaymentRailType.fednow)
await session.complete();- SDK: emit the OTel attribute shown on this page during the decision workflow.
- Policy: reference the matching `opa_policy_path` in governance rules.
- Evidence: surface the same label and value in the portal and exported record so reviewers are not translating between systems.
For a step-by-step getting-started walkthrough specific to this vertical, open the Banking & Financial Services SDK quick start. For the full core API reference, continue with TypeScript, Python, or .NET.
Register a free Builder account for full SDK and REST API access, enter the live demo if you want to see the portal first, or request a coverage workshop if your team wants a guided review of this vertical before implementation starts.
Highlighted Enum Categories
| Enum | OTel Attribute | Values |
|---|---|---|
| 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 | banking.payment.iso20022_status | ACTC, ACCP, ACSP, ACSC, ACWC, ACWP, RCVD, PDNG |
| 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 | banking.payment.message_type | pain.001, pain.002, pain.008, pain.013, pain.014, pacs.002, pacs.003, pacs.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 | banking.payment.rail | fednow, ach_credit, ach_debit, same_day_ach, chaps, fedwire, chips, swift_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 | banking.payment.purpose_code | BEXP, CASH, CBLK, CCRD, CDBL, CORT, DCRD, DIVI |
| 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 | banking.payment.agent_action | initiate_credit_transfer, initiate_direct_debit, request_payment_cancellation, request_return, request_reversal, request_status_update, apply_payment_preference, route_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 | banking.sanctions.screening_outcome | clear, potential_hit, confirmed_hit, false_positive_cleared, deferred_for_review, blocked, escalated_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 | banking.fraud.model_type | rules_based_engine, ml_supervised_classifier, ml_unsupervised_anomaly, graph_network_analysis, behavioral_biometrics, device_fingerprinting, llm_narrative_analysis, ensemble_hybrid |
| FraudAlertDisposition The analyst or agent disposition of a fraud alert after review. Must be logged immutably for SR 11-7 model performance monitoring and CFPB adverse action requirements. Workflow area: Fraud Detection & Financial Crime | banking.fraud.alert_disposition | true_positive_fraud_confirmed, false_positive_cleared, suspected_fraud_monitoring, transaction_blocked, transaction_reversed, customer_contacted, account_restricted, account_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 | banking.fraud.case_resolution_state | initiated, documentation_requested, investigation_in_progress, customer_liability_assessed, bank_liability_assessed, reversal_processed, chargeback_filed, arbitration_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 | banking.aml.alert_status | system_generated, under_review, escalated_to_l2_analyst, escalated_to_compliance_officer, sar_decision_pending, sar_filed, sar_declined_documented, closed_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 | banking.aml.typology | structuring_smurfing, layering_wire_transfers, trade_based_money_laundering, real_estate_placement, shell_company_layering, crypto_mixing_tumbling, hawala_informal_value_transfer, loan_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 | banking.kyc.status | unverified, pending_documentation, identity_check_in_progress, document_verification_in_progress, biometric_check_in_progress, verified_standard, verified_enhanced_due_diligence, rejected |
This reference page is rendered from the mirrored JSON file inside the docs app, not from a hand-written website model.
If you need the machine-readable asset for offline review, automation, or internal diffing, use the mirrored JSON download above.
Next: open the corresponding SDK reference under SDK documentation and then compare it with the public-site industry page to see how the same vocabulary is framed commercially.