10 January 2024 - Release Notes
- 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 | 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 | Y | Alpha | |
cardholderZip | 9 | No dashes Has to be minimum of 5 digits or 9 digits if more than 5. | Y | Numeric |
cardholderCountry | 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 | <Field Name> : Invalid Format |
Size (S) | AB3010 | <Field Name> : Invalid Length |
Required (R) | AB3013 | <Field Name> : Missing Required Field |