21 September 2023 - Release Notes
- New
transfer
endpoint - Updates to the Payment Status Webhook and
payments
endpoint - Sandbox customer onboarding defect resolutions
Avenu API Release Notes 1.8.0
Overview
New transfer
endpoint to assist with remittance flows
transfer
endpoint to assist with remittance flowsA new endpoint for internal client transfers has been created. The transfer
endpoint will help facilitate automatic transfers from the customer's account to the client MSB account. Updates to the Payment Status Webhook and statement
endpoint are included with this release. Full details of the new endpoint can be found here.
Updates to the Payment Status Webhook and payments
endpoint
payments
endpointAs part of the rollout for the new transfer
endpoint we've updated the Payment Status Webhook and payments
endpoint to reflect the new payment type.
Sandbox Customer Onboarding Defect Resolutions
We've fixed the issue with onboarding customers to trigger a DISABLED
or ID_SCAN
status.
What's New?
The following release notes detail the updates we have included in this release.
Introduction of the new transfer
endpoint
transfer
endpointPOST {prefix}/client/v1/transfer
We have created a new endpoint to help facilitate the movement of funds from a customer's account to the client's MSB account. The transfer
endpoint will allow a customer to easily use their funds for a remittance workflow, specifically to send money internationally.
Example Request
{
"customerAccount": {
"achAccountNumber": "" // Customer account number, routing number is hard coded
},
"customerAuthorized" : {
"authorizedBy" : "John Smith", // Name
"authorizationTimestampGMT" : "08/04/2023 HH:MM" //date and timestamp in GMT
}
"amount": "", // Amount will be postitive. The payment amount in lowest currency denomination e.g. cents. (Internal ONLY Negative for debit)
"transferType": "", // Pulls data from Account Array in client profile for corresponding ACH account number
"currency": "", // Currency descriptor
"memo": "", // A message to accompany the payment
}
Example Response
{
"transfer": {
"transferType": "REMITTANCE", // example from the first column in the account array
"mainstreetBankAccount": {
"transferAccountNumber": "",
"achRoutingNumber": ""
},
"amount": xxx,
"currency": "usd",
"scheduledDate": "",
"numberOfPayments": "",
"paymentsInterval": "",
"memo": "",
"firstName" : "",
"middleInitial" : "",
"lastName" : "",
"address" : "",
"city" : "",
"state" : "",
"zipCode" : "",
"country" : "",
"authorizedBy" : "John Smith", // Name
"authorizationTimestampGMT" : "08/04/2023" //Date and timestamp
},
"paymentId": "xxxx", // UUID payment identifier
"sender": "", // sender account number
"status": "", // status of payment at end of transaction. See link below.
"dateCreated": "", // Transaction processed date in format ISO 8601 YYYY-MM-DD. See link below
"dateUpdated": "", // Date of last status update in format ISO 8601 YYYY-MM-DD
"publicTraceNumber": "xxxxxxxx"
}
Full details on implementing this new endpoint can be found here.
Additional updates for the transfer
endpoint
transfer
endpointAs part of the new transfer
endpoint deployment we have updated our payments
endpoint to support the new transfer payment type, and we have updated our Payment Status Webhook to reflect these changes as well.
A service has been created for the transfer
endpoint that will append Transfer to [client name]
to the memo field of each payment initiated through the transfer endpoint. Additional details can be found here.
The Payment Status Webhook has been enhanced to include ACH_TRANSFER
payment type statuses. Additional details can be found here.
Sandbox - Customer Onboarding Defect Resolutions
Previously, if a customer was attempted to be onboarded in a "DISABLED" or "ID_SCAN" state a 503 error would occur with the message "An unknown error has occurred. Please contact a system administrator." This error no longer occurs and client testing of customer onboarding in Sandbox can continue.