customer/v2/dispute

[POST] customer/v2/dispute

Create a dispute

The V2 Dispute endpoint introduces a new required field disputeAmount with value string. The new endpoint also incorporates automation with the compliance monitoring system so that disputes can be researched, worked, and adjudicated with updates reflected back in Avenu when an adjustment is needed.

Customers can dispute a transaction utilizing the create dispute endpoint. This is used for fraudulent and/or unauthorized charges that may appear on the customer's ledger. Creating a dispute does not guarantee a resolution in the customer's favor. The status will be pending until the dispute case is handled in the compliance monitoring system by administration. As updates to the dispute are made within the compliance monitoring system, real time notifications will be sent via webhook.

Please note: Customers cannot dispute a debit transfer. The acceptable payments types which can be disputed in Avenu are:

• ACH
• AVENU (Intra client payments from one customer to another customer)
• ACH_TRANSFER (transfers to the REMITTANCE and/or OPERATING account(s) via the transfer endpoint)

Only one dispute can be created per original transaction. Additionally, a transaction must be in SETTLED state for a dispute to be possible.

deviceIdentity is optional, but it is passed to our vendor for help with compliance case management (refunds, fraud, etc.).

Example [POST] Request

{{avenu_base_url}}/customer/v2/dispute

 {
    "transactionID": "",
    "disputeReason": "",
    "disputeAmount": "",
    "disputeType": "",
    "declarationAcknowledged": true,
    "deviceIdentity": {
        "deviceId": "",
        "deviceType": "",
        "deviceName": "",
        "deviceOperatingSystem": "",
        "deviceIPAddress": "",
        "deviceLocation": "",
        "deviceLongitude": "",
        "deviceLatitude": "",
        "deviceUser": "",
        "deviceIMEINumber" : "",
        "deviceTorEnabled" : "",
        "deviceFirstSeen" : "",
        "deviceLastSeen" : ""
    }
 }

Input Parameters

Dispute Type ENUM

Example Response

{
     "disputeID": "",
     "dateCreated": "",  
     "status": ""
 }

Response Elements

Error Codes

Get updates on dispute status via webhook

As updates to the dispute are made within the compliance monitoring system, real time notifications will be sent via webhook. Learn more about dispute status webhook notifications.

[GET] customer/v2/dispute

Get dispute status

The current status of a dispute can be retrieved by passing the unique disputeID as a parameter to the V2 dispute endpoint.

Example [GET] request

{{avenu_base_url}}/customer/v2/dispute/{{disputeID}}

Example [GET] response

{
    "disputeId": "",
    "disputeStatus": "CREATED",
    "dateUpdated": "",
    "customerAccountNumber": "",
    "transactionId": "",
    "amount": 123,
    "currencyType": "USD",
    "disputeReason": "",
    "disputeType": "UNAUTHORIZED",
    "disputeResolution": "Dispute has been created in the Compliance Monitoring System - pending review",
    "memo": ""
}

Dispute statuses