10 January 2024 - Release Notes
8 months ago by Mike Ireson
- Input validation and sanitization of the
token fund(debit card) endpoint 💳 - Improvements and fixes for handling ACH return files
Avenu API Release Notes 1.9.0
Overview
Input validation and sanitization of the token fund (debit card) endpoint
token fund (debit card) endpointThis release includes enhancing the endpoint to enforce size, format, and mandatory restrictions on parameters. Error response codes were also enhanced to provide and present concise and specific feedback.
Improvements and fixes for handling ACH return files
We have updated how we handle empty ACH return files from our vendor, as well as fixed an issue related to the processing and issuing of the payment webhook notification for returns.
What's New?
The following release notes detail the updates we have included in this release.
Input validation and sanitization of the token fund (debit card) endpoint
token fund (debit card) endpointPOST {avenu_base_url}/customer/v1/token/fund
The endpoint is now enforcing size, format, and mandatory restrictions on parameters. Error response codes have also been updated to provide a more meaningful message to the calling application/customer regarding the field(s) in error.
Input Parameters
| Parameter | Size/Absolute Value Restrictions | Format Restrictions | Required | Type |
|---|---|---|---|---|
| amount | >=100 and <= 100000 | Funding amount in the lowest currency (cents) | Y | Numeric |
| currency | 3 | ISO 4217 | Y | String |
| memo | 200 | None | N | Alphanumeric |
| cardType | 50 | Should accept "TOKEN" only | Y | Alpha |
| cardholderFirstName | 50 | No special characters (" !"#$%'*+.:;<=>?@[]^_`{|}~") | Y | Alpha |
| cardholderLastName | 50 | No special characters (" !"#$%'*+.:;<=>?@[]^_`{|}~") | Y | Alpha |
| cardholderCompany | 100 | No special characters " !"#$%'*+.:;<=>?@[]^_`{|}~" Except: ()'-&,/ | N | Alphanumeric |
| cardholderAddress1 | 128 | None | Y | Alphanumeric |
| cardholderAddress2 | 128 | None | N | Alphanumeric |
| cardholderCity | 100 | No special characters (" !"#$%'*+.:;<=>?@[]^_`{|}~") | Y | Alpha |
| cardholderState | 2 | ISO 3166-2:US | Y | Alpha |
| cardholderZip | 9 | No dashes Has to be minimum of 5 digits or 9 digits if more than 5. | Y | Numeric |
| cardholderCountry | 2 | ISO 3166 - alpha 2 | N | Alpha |
| cardholderPhone | 10 | No special characters (" !"#$%'*+:;<=>?[]^_`{|}~") No dashes or hyphens | N | Numeric |
| cardholderEmail | 320 | No special characters (" !"#$%'*+:;<=>?[]^_`{|}~") Exception: “At” sign - “@” allowed directly preceding the domain name. Alphanumeric prefix with the @ symbol followed by most common Top Level Domains (TLDs) .com/.co/.net/.org/.edu/.gov/.us | N | Alphanumeric |
Error Codes
| Category | Response Code | Response Error Message |
|---|---|---|
| Format | AB3006 | : Invalid Format |
| Size (S) | AB3010 | : Invalid Length |
| Required (R) | AB3013 | : Missing Required Field |