emv-3ds 0.2.0

EMV 3-D Secure 2.x (3DS2) protocol — AReq/ARes/CReq/CRes messages, transaction state machine, ECI/CAVV helpers, and full EMVCo spec serialization for payment authentication (SCA/PSD2)
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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144

pub mod areq;
pub mod ares;
pub mod creq;
pub mod cres;
pub mod error_msg;
pub mod preq;
pub mod pres;
pub mod rreq;
pub mod rres;

pub use areq::AuthenticationRequest;
pub use ares::AuthenticationResponse;
pub use creq::ChallengeRequest;
pub use cres::ChallengeResponse;
pub use error_msg::ErrorMessage;
pub use preq::PreparationRequest;
pub use pres::{CardRangeData, PreparationResponse};
pub use rreq::{MessageExtension, ResultsRequest};
pub use rres::ResultsResponse;

use serde::{Deserialize, Serialize};

/// A type-erased EMV 3DS message, dispatched by the `messageType` field.
#[derive(Debug, Clone)]
pub enum Message {
    AReq(Box<AuthenticationRequest>),
    ARes(AuthenticationResponse),
    CReq(ChallengeRequest),
    CRes(ChallengeResponse),
    Erro(ErrorMessage),
    PReq(Box<PreparationRequest>),
    PRes(PreparationResponse),
    RReq(ResultsRequest),
    RRes(ResultsResponse),
}

impl Message {
    pub fn from_json(json: &str) -> crate::error::Result<Self> {
        let peek: serde_json::Value = serde_json::from_str(json)?;
        let tag = peek
            .get("messageType")
            .and_then(|v| v.as_str())
            .ok_or(crate::error::Error::MissingField("messageType"))?;

        match tag {
            "AReq" => {
                let m: AuthenticationRequest = serde_json::from_value(peek)?;
                Ok(Self::AReq(Box::new(m)))
            }
            "ARes" => Ok(Self::ARes(serde_json::from_value(peek)?)),
            "CReq" => Ok(Self::CReq(serde_json::from_value(peek)?)),
            "CRes" => Ok(Self::CRes(serde_json::from_value(peek)?)),
            "Erro" => Ok(Self::Erro(serde_json::from_value(peek)?)),
            "PReq" => {
                let m: PreparationRequest = serde_json::from_value(peek)?;
                Ok(Self::PReq(Box::new(m)))
            }
            "PRes" => Ok(Self::PRes(serde_json::from_value(peek)?)),
            "RReq" => Ok(Self::RReq(serde_json::from_value(peek)?)),
            "RRes" => Ok(Self::RRes(serde_json::from_value(peek)?)),
            other => Err(crate::error::Error::Protocol {
                code: "405".to_owned(),
                description: format!("unknown messageType: {other}"),
            }),
        }
    }

    pub fn to_json(&self) -> crate::error::Result<String> {
        match self {
            Self::AReq(m) => serde_json::to_string(m.as_ref()),
            Self::ARes(m) => serde_json::to_string(m),
            Self::CReq(m) => serde_json::to_string(m),
            Self::CRes(m) => serde_json::to_string(m),
            Self::Erro(m) => serde_json::to_string(m),
            Self::PReq(m) => serde_json::to_string(m.as_ref()),
            Self::PRes(m) => serde_json::to_string(m),
            Self::RReq(m) => serde_json::to_string(m),
            Self::RRes(m) => serde_json::to_string(m),
        }
        .map_err(Into::into)
    }
}

impl Serialize for Message {
    fn serialize<S: serde::Serializer>(&self, s: S) -> Result<S::Ok, S::Error> {
        match self {
            Self::AReq(m) => m.serialize(s),
            Self::ARes(m) => m.serialize(s),
            Self::CReq(m) => m.serialize(s),
            Self::CRes(m) => m.serialize(s),
            Self::Erro(m) => m.serialize(s),
            Self::PReq(m) => m.serialize(s),
            Self::PRes(m) => m.serialize(s),
            Self::RReq(m) => m.serialize(s),
            Self::RRes(m) => m.serialize(s),
        }
    }
}

impl<'de> Deserialize<'de> for Message {
    fn deserialize<D: serde::Deserializer<'de>>(d: D) -> Result<Self, D::Error> {
        let v = serde_json::Value::deserialize(d)?;
        let tag = v
            .get("messageType")
            .and_then(|t| t.as_str())
            .ok_or_else(|| serde::de::Error::missing_field("messageType"))?;

        match tag {
            "AReq" => serde_json::from_value::<AuthenticationRequest>(v)
                .map(|m| Self::AReq(Box::new(m)))
                .map_err(serde::de::Error::custom),
            "ARes" => serde_json::from_value(v)
                .map(Self::ARes)
                .map_err(serde::de::Error::custom),
            "CReq" => serde_json::from_value(v)
                .map(Self::CReq)
                .map_err(serde::de::Error::custom),
            "CRes" => serde_json::from_value(v)
                .map(Self::CRes)
                .map_err(serde::de::Error::custom),
            "Erro" => serde_json::from_value(v)
                .map(Self::Erro)
                .map_err(serde::de::Error::custom),
            "PReq" => serde_json::from_value::<PreparationRequest>(v)
                .map(|m| Self::PReq(Box::new(m)))
                .map_err(serde::de::Error::custom),
            "PRes" => serde_json::from_value(v)
                .map(Self::PRes)
                .map_err(serde::de::Error::custom),
            "RReq" => serde_json::from_value(v)
                .map(Self::RReq)
                .map_err(serde::de::Error::custom),
            "RRes" => serde_json::from_value(v)
                .map(Self::RRes)
                .map_err(serde::de::Error::custom),
            other => Err(serde::de::Error::unknown_variant(
                other,
                &[
                    "AReq", "ARes", "CReq", "CRes", "Erro", "PReq", "PRes", "RReq", "RRes",
                ],
            )),
        }
    }
}