Struct KycProfile 

pub struct KycProfile {

    pub declared_purpose: String,
    pub expected_monthly_turnover: TurnoverBand,
    pub expected_transaction_frequency: FrequencyBand,
    pub expected_categories: Vec<ExpectedCategory>,
    pub source_of_funds: SourceOfFunds,
    pub source_of_wealth: Option<SourceOfWealth>,
    pub geographic_exposure: Vec<CountryExposure>,
    pub cash_intensity: CashIntensity,
    pub beneficial_owner_complexity: u8,
    pub international_rate: f64,
    pub large_transaction_rate: f64,
    pub large_transaction_threshold: u64,
    pub completeness_score: f64,
    pub true_source_of_funds: Option<SourceOfFunds>,
    pub true_turnover: Option<TurnoverBand>,
    pub is_truthful: bool,
}

KYC profile defining expected customer activity.

Fields

declared_purpose: String

Declared purpose of the account

expected_monthly_turnover: TurnoverBand

Expected monthly turnover band

expected_transaction_frequency: FrequencyBand

Expected transaction frequency band

expected_categories: Vec<ExpectedCategory>

Expected merchant/transaction categories

source_of_funds: SourceOfFunds

Declared source of funds

source_of_wealth: Option<SourceOfWealth>

Declared source of wealth (for HNW)

geographic_exposure: Vec<CountryExposure>

Geographic exposure (countries)

cash_intensity: CashIntensity

Expected cash intensity

beneficial_owner_complexity: u8

Beneficial owner complexity score (0-10)

international_rate: f64

Expected international transaction rate (0.0-1.0)

large_transaction_rate: f64

Expected large transaction rate (0.0-1.0)

large_transaction_threshold: u64

Threshold for “large” transaction

completeness_score: f64

KYC completeness score (0.0-1.0)

true_source_of_funds: Option<SourceOfFunds>

True source of funds (if different from declared)

true_turnover: Option<TurnoverBand>

True expected turnover (if different from declared)

is_truthful: bool

Whether the KYC profile is truthful

Implementations

impl KycProfile

pub fn new(purpose: &str, source_of_funds: SourceOfFunds) -> Self

Create a new KYC profile.

pub fn retail_standard() -> Self

Create a profile for a retail customer.

pub fn high_net_worth() -> Self

Create a profile for a high net worth customer.

pub fn small_business() -> Self

Create a profile for a small business.

pub fn cash_intensive_business() -> Self

Create a profile for a cash-intensive business.

pub fn with_turnover(self, turnover: TurnoverBand) -> Self

Set turnover band.

pub fn with_frequency(self, frequency: FrequencyBand) -> Self

Set frequency band.

pub fn with_expected_category(self, category: ExpectedCategory) -> Self

Add expected category.

pub fn with_country_exposure(self, exposure: CountryExposure) -> Self

Add geographic exposure.

pub fn with_cash_intensity(self, intensity: CashIntensity) -> Self

Set cash intensity.

pub fn with_deception( self, true_source: SourceOfFunds, true_turnover: Option<TurnoverBand>, ) -> Self

Set as deceptive (ground truth differs from declared).

pub fn calculate_risk_score(&self) -> u8

Calculate risk score based on profile.

pub fn is_within_expected_turnover(&self, actual_monthly: u64) -> bool

Check if actual activity matches expected.

pub fn is_within_expected_frequency(&self, actual_count: u32) -> bool

Check if transaction frequency is within expected.

Trait Implementations

impl Clone for KycProfile

fn clone(&self) -> KycProfile

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for KycProfile

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for KycProfile

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for KycProfile

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for KycProfile

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.