|
20 | 20 | "Avs", |
21 | 21 | "Card", |
22 | 22 | "Merchant", |
| 23 | + "NameValidation", |
| 24 | + "NameValidationName", |
| 25 | + "NameValidationNameOnFileMatch", |
23 | 26 | "ServiceLocation", |
24 | 27 | "FleetInfo", |
25 | 28 | "LatestChallenge", |
@@ -149,6 +152,43 @@ class Merchant(merchant.Merchant): |
149 | 152 | """Street address of card acceptor.""" |
150 | 153 |
|
151 | 154 |
|
| 155 | +class NameValidationName(BaseModel): |
| 156 | + """Cardholder name as provided by the card network.""" |
| 157 | + |
| 158 | + first: str |
| 159 | + """First name""" |
| 160 | + |
| 161 | + last: str |
| 162 | + """Last name""" |
| 163 | + |
| 164 | + middle: Optional[str] = None |
| 165 | + """Middle name""" |
| 166 | + |
| 167 | + |
| 168 | +class NameValidationNameOnFileMatch(BaseModel): |
| 169 | + """ |
| 170 | + Lithic's computed match result comparing the network-provided name to the name on file. |
| 171 | + """ |
| 172 | + |
| 173 | + full_name: Literal["MATCH", "PARTIAL_MATCH", "NO_MATCH", "UNVERIFIED"] |
| 174 | + """Overall name match result.""" |
| 175 | + |
| 176 | + |
| 177 | +class NameValidation(BaseModel): |
| 178 | + """ |
| 179 | + Network name validation data, present when the card network requested name validation for this transaction. Contains the cardholder name provided by the network and Lithic's computed match result against KYC data on file. |
| 180 | + """ |
| 181 | + |
| 182 | + name: NameValidationName |
| 183 | + """Cardholder name as provided by the card network.""" |
| 184 | + |
| 185 | + name_on_file_match: NameValidationNameOnFileMatch |
| 186 | + """ |
| 187 | + Lithic's computed match result comparing the network-provided name to the name |
| 188 | + on file. |
| 189 | + """ |
| 190 | + |
| 191 | + |
152 | 192 | class ServiceLocation(BaseModel): |
153 | 193 | """ |
154 | 194 | Where the cardholder received the service, when different from the card acceptor location. This is populated from network data elements such as Mastercard DE-122 SE1 SF9-14 and Visa F34 DS02. |
@@ -470,6 +510,13 @@ class CardAuthorization(BaseModel): |
470 | 510 | merchant_currency: str |
471 | 511 | """3-character alphabetic ISO 4217 code for the local currency of the transaction.""" |
472 | 512 |
|
| 513 | + name_validation: Optional[NameValidation] = None |
| 514 | + """ |
| 515 | + Network name validation data, present when the card network requested name |
| 516 | + validation for this transaction. Contains the cardholder name provided by the |
| 517 | + network and Lithic's computed match result against KYC data on file. |
| 518 | + """ |
| 519 | + |
473 | 520 | service_location: Optional[ServiceLocation] = None |
474 | 521 | """ |
475 | 522 | Where the cardholder received the service, when different from the card acceptor |
|
0 commit comments