Skip to Content

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.

v2026.03.1636 enum categories2.2 schema8 subdomains11 standards

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.

Download vocabulary JSONOpen industry SDK quickstartStart free for 60 days 

How to use this reference

  1. Start with the core file if you need the cross-industry governance baseline.
  2. Choose an industry file for its workflow fields and permitted values.
  3. 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

banking

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

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)

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, and transformed results 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.

Start your Developer evaluation

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
  • 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

OTel attribute
banking.payment.message_type
First 8 permitted values
  • 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

OTel attribute
banking.payment.rail
First 8 permitted values
  • 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

OTel attribute
banking.payment.purpose_code
First 8 permitted values
  • 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

OTel attribute
banking.payment.agent_action
First 8 permitted values
  • 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

OTel attribute
banking.sanctions.screening_outcome
Permitted values
  • 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

OTel attribute
banking.fraud.model_type
First 8 permitted values
  • rules_based_engine
  • ml_supervised_classifier
  • ml_unsupervised_anomaly
  • graph_network_analysis
  • behavioral_biometrics
  • device_fingerprinting
  • llm_narrative_analysis
  • ensemble_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_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

OTel attribute
banking.fraud.case_resolution_state
First 8 permitted values
  • 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

OTel attribute
banking.aml.alert_status
First 8 permitted values
  • 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

OTel attribute
banking.aml.typology
First 8 permitted values
  • 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

OTel attribute
banking.kyc.status
First 8 permitted values
  • unverified
  • pending_documentation
  • identity_check_in_progress
  • document_verification_in_progress
  • biometric_check_in_progress
  • verified_standard
  • verified_enhanced_due_diligence
  • rejected

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.

Last updated on