fints-rs 0.1.0

Native Rust FinTS 3.0 PinTan client for German online banking
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

//! Bank registry: known German banks with their FinTS endpoint URLs.
//!
//! Banks are identified solely by their BLZ (Bankleitzahl). There is no
//! separate `id` field — the BLZ is the canonical identifier.

use serde::{Deserialize, Serialize};

use crate::types::{BankName, Bic, Blz, FinTSUrl};

/// Configuration for a known bank.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct BankConfig {
    pub name: BankName,
    pub blz: Blz,
    pub bic: Bic,
    pub url: FinTSUrl,
}

impl BankConfig {
    /// Create a new BankConfig.
    pub fn new(
        name: impl Into<String>,
        blz: impl Into<String>,
        bic: impl Into<String>,
        url: impl Into<String>,
    ) -> Self {
        Self {
            name: BankName::new(name),
            blz: Blz::new(blz),
            bic: Bic::new(bic),
            url: FinTSUrl::new(url),
        }
    }

    /// Create a BankConfig from raw (blz, bic, name, url) — used by generated code.
    pub fn new_raw(
        blz: impl Into<String>,
        bic: impl Into<String>,
        name: impl Into<String>,
        url: impl Into<String>,
    ) -> Self {
        Self {
            blz: Blz::new(blz),
            bic: Bic::new(bic),
            name: BankName::new(name),
            url: FinTSUrl::new(url),
        }
    }
}

/// Get all known banks with FinTS PIN/TAN access.
pub fn all_banks() -> Vec<BankConfig> {
    crate::banks_generated::generated_all_banks()
}

/// Look up a bank by its BLZ (bank code).
pub fn bank_by_blz(blz: &str) -> Option<BankConfig> {
    crate::banks_generated::generated_bank_by_blz(blz)
}