Skip to Content

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.

v2026.03.1636 enum categories2.2 schema8 subdomains12 standards

Back to industry coverage library

Download mirrored JSONOpen vertical SDK quick startGet API access

How to use this reference

  1. Start with the core file if you need the cross-industry governance baseline.
  2. Then move into the vertical file to see the regulated workflow vocabulary, policy surfaces, and implementation pressure unique to this market.
  3. 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

banking

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

Subdomains

SubdomainCategoriesSample Attributes
Payments & Funds Transfer6banking.payment.iso20022_status, banking.payment.message_type, banking.payment.rail
Fraud Detection & Financial Crime7banking.fraud.model_type, banking.fraud.alert_disposition, banking.fraud.case_resolution_state
Lending & Credit6banking.loan.application_status, banking.credit.decision_type, banking.credit.adverse_action_reason
Treasury, Capital Markets & Liquidity5banking.treasury.liquidity_action, banking.capital.ratio_type, banking.capital.rwa_approach
Customer Lifecycle & Onboarding3banking.onboarding.stage, banking.customer.risk_category, banking.customer.consent_type
Model Risk Management3banking.model_risk.validation_status, banking.model_risk.change_type, banking.model_risk.inventory_status
Regulatory Reporting & Compliance4banking.regulatory_report.type, banking.regulatory_report.status, banking.dora.incident_classification
Digital Assets & Crypto2banking.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.

Ready to connect your first workflow?

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.

Live demo →Get API access →Request coverage workshop →

Highlighted Enum Categories

EnumOTel AttributeValues
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_statusACTC, 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_typepain.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.railfednow, 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_codeBEXP, 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_actioninitiate_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_outcomeclear, 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_typerules_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_dispositiontrue_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_stateinitiated, 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_statussystem_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.typologystructuring_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.statusunverified, 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.

Last updated on