customer/v1/dispute

[POST] customer/v1/dispute

Create a dispute

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 case management system by administration.

Please note: Customers cannot dispute a debit transfer. Only ACH transfers may be disputed. Additionally, a transaction must be in SETTLED state for a dispute to be possible.

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

Example [POST] Request

{{avenu_base_url}}/customer/v1/dispute

 {
    "transactionID": "",
    "disputeReason": "",
    "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": "",
     "dateUpdated": "",
     "memo": "",
     "amount": "",
     "currencyType": "",  
     "status": ""
 }

Response Elements

Error Codes

[GET] customer/v1/dispute

Get dispute status

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

Dispute status

Example [GET] Request

{{avenu_base_url}}/customer/v1/dispute/{{disputeID}}

Request Parameter

Example Response

{
    "disputeID": "",
    "dateUpdated": "",
    "memo": "",
    "amount": xxx,
    "currencyType": "",
    "status": ""
}

Response Elements