13 November 2024 - Release Notes

Configure ACH Transfer limit per client 💵
Government ID parameters validation 🪪
Support ADJUSTMENT transaction in payment details endpoint
New payment webhook notifications for ADJUSTMENT and MANUAL_ADJUSTMENT types

Avenu API Release Notes 1.12.3.2

What's New?

Configure ACH Transfer limit per client 💵

With this release, Avenu now supports setting a limit on ACH_TRANSFER transactions on a per client basis. The global default value is $1000, unless configured otherwise. Please reach out to Avenu Integration Support ([email protected]) to discuss this setting for your organization.

Government ID parameters validation 🪪

We've added validation around the combination of Government ID's submitted during customer onboarding. A SSN is still required for all onboarding attempts, and this can be combined with a DRIVER_LICENSE, ID_CARD, and/or PASSPORT. If an onboarding attempt is made with an invalid combination of Government ID's, for example submitting two SSN's, the response will include the following error:

Response Code	Response Error Message
AA8003	Multiple IDs submitted - provide single ID per ID Type

Support ADJUSTMENT transaction in payment details endpoint

The payment details endpoint has been updated to allow ADJUSTMENT transactions. Now, when passing the paymentID of an ADJUSTMENT in the GET URL parameter, the payment details will be returned.

Example GET

{{avenu_base_url}}/customer/v1/payment/j.5b1ff425-2b79-412f-a7dd-ded6e9e87f2d

Example response

{
    "payment": {
        "paymentType": "ADJUSTMENT",
        "recipientAccount": {
            "customerAccountNumber": "",
            "achAccountNumber": "",
            "achRoutingNumber": "",
            "debitCardNumber": "",
            "debitCardExpiration": "",
            "debitCardCvv": ""
        },
        "amount": -1000,
        "currency": "USD",
        "scheduledDate": "",
        "numberOfPayments": "",
        "paymentsInterval": "",
        "memo": "DISPUTE_SETTLEMENT",
        "firstName": "",
        "middleInitial": "",
        "lastName": "",
        "address": "",
        "city": "",
        "state": "",
        "zipCode": "",
        "country": ""
    },
    "paymentId": "j.5b1ff425-2b79-412f-a7dd-ded6e9e87f2d",
    "status": "",
    "dateCreated": "",
    "dateUpdated": "",
    "returnCode": "",
    "publicTraceNumber": ""
}

New payment webhook notifications for ADJUSTMENT and MANUAL_ADJUSTMENT types

Aligning with other transactions, we've updated our webhook service to provide notification for ADJUSTMENT and MANUAL_ADJUSTMENT payment status changes. Please see example payloads below:

Webhook notification payment status payload data - New Adjustment transaction

{
  "type": "payment",
  "created_at": "2021-12-07T00:21:40.670058Z",
  "data": {
    "customer": {
        "accountNumber" : "12345"
    },
    "transaction": {        
        "id": "12345abc",
        "type": "ADJUSTMENT",
        "status": "SETTLED",
        "transactionResponse": {
            "type": "TRANSACTION",
            "description": "Transaction updated",
            "dateUpdated": "2021-12-07"
        }        
    }
  }
}

Webhook notification payment status payload data - New Manual Adjustment transaction

{
  "type": "payment",
  "created_at": "2021-12-07T00:21:40.670058Z",
  "data": {
    "customer": {
        "accountNumber" : "12345"
    },
    "transaction": {        
        "id": "12345abc",
        "type": "MANUAL_ADJUSTMENT",
        "status": "SETTLED",
        "transactionResponse": {
            "type": "TRANSACTION",
            "description": "Transaction updated",
            "dateUpdated": "2021-12-07"
        }        
    }
  }
}