customer/v1/complaint

[POST] /customer/v1/complaint

Allow customers to create a complaint

Effective complaint management is crucial for a comprehensive compliance program. Complaints provide insights to enhance customer satisfaction, program delivery, and service quality, while aiding examiners in assessing consumer compliance and risk. This system allows customers to submit concerns directly through the client's application, creating a case in a secure database. This ensures clear and effective complaint management that meets examiner standards.

This endpoint allows customers to submit concerns regarding experiences within the client's application on the Avenu platform. A submission should include details of the concern as well as the complainants information and relevant identifiers for the issues presented. The Content Type for the request is multipart/form-datawith TEXT jsonData and FILE filesrequired. The value for files is optional. Avenu accepts the following file formats; it is up to client discretion what format they will request or allow. File Format: PNG, JPG, JPEG, PDF

Example [POST] Request jsonData

{{avenu_base_url}}customer/v1/complaint

{
    "productType": "",                
    "serviceType": "",                 
    "customerComplainingAbout": "",      
    "detailsOfIssue": "",                              
    "dateEventOccured": "",       
     "deviceIdentity": {
        "deviceId" : "",                  
        "deviceType" : "",                
        "deviceName" : "",                
        "deviceOperatingSystem" : "",     
        "deviceIPAddress" : "",           
        "deviceLocation" : "",            
        "deviceLongitude" : "",           
        "deviceLatitude" : "",           
        "deviceUser" : "",               
        "deviceIMEINumber" : "",          
        "deviceTorEnabled" : "",          
        "deviceFirstSeen" : "",           
        "deviceLastSeen" : ""             
    }        

}

JSON object Parameters

Example Response

{
    "customerID": "",
    "customerName": "",
    "complaintID": "This will be Avenu UUID of the complaint",
    "productType": "",
    "customerComplainingAbout": "",
    "detailsOfIssue": "",
    "dateComplaintRecieved": ""
}

Response Parameters

Error Codes

For Required, Size, and Format restrictions an error code may be returned for each field. Errors related to the endpoint fields will be returned as an AP error with a description. Only one error code is returned per field each time in that order. For example, if firstName is >50 characters and has special characters, only the size restriction error code and message will be sent back first as:

{
    "code": "CA3107",
    "message": "firstName: Invalid Length"
}

Webhook Notifications

Please reference the Webhooks page for information on Complaint webhook notifications.