August 6, 2024
Improving avs.zipcode
Values in ASA
avs.zipcode
Values in ASABeginning on August 19th, we will deploy an improvement which aligns the behavior of the avs.zipcode
field (contained within the ASA request) with our existing product documentation (ASA request spec). Today, Lithic truncates any value provided in card network messages to 5 characters. This can create scenarios where non-US postal codes are unnecessarily shortened or US ZIP codes mistakenly entered with spaces are not passed through in full. For example, a Canadian postal code of V6E 0C6
is shortened to V6E 0
or a US ZIP code entered with an accidental space 89 109
becomes 89 10
.
With this release, customers may begin receiving longer strings in the zipcode
field than were previously passed. Our documentation states that the zipcode
value can have a variable length, and we currently pass variable length values in this field which are shorter than 5 characters (e.g. 2 character values). With this release, customers will be able to receive full US 9-digit ZIPs as well as international postal codes in their full lengths, better aligning production behavior with product documentation.
If you have any questions or concerns about this change, please reach out to [email protected].
[Update 8/7] - Previously, this changelog included mentions of updates affecting the transaction object. These references have been removed as there will be no impact to transactions (which already exhibit the expected behavior).