Tutelar API Stack
  • Introduction
  • Fraud Detection Monitoring
    • Create Transaction
    • Notify Transaction
    • Chargeback Transaction
    • Refund Transaction
  • MERCHANT ONBOARDING
    • Client Types
    • Entity Types
    • MCC Lists
    • Reseller Lists
    • Onboarding
    • Onboarding - KYC
    • Onboarding - Web Crawling
    • Onboarding - AML
    • Onboarding - NDI
  • KYC Verification
    • Document Verification
      • 🇮🇳India
        • Aadhaar Card
        • Pan Card
        • Driving License
        • GST Number
        • Passport
        • Shop License
        • FSSAI
        • MCA
        • Voter Id
        • Pan Gst Link
        • ROC IEC
        • DIN
        • Udyam Aadhaar
        • Pan Card Comprehensive
        • Name Compare
        • GST Advanced
        • Aadhar with Otp
        • Phone Name Attributes
        • Pan Card Lite
    • Document Extraction
      • 🇮🇳India
        • Aadhaar Card
        • Pan Card
        • Driving License
        • Voter Id
        • GST Certificate
        • Passport
    • Assets Verification
      • 🇮🇳India
        • Bank Account
        • Bank Verfication Pennyless
        • Bank Account Details Using VPA
        • Mobile to UPI Advance
        • Mobile to UPI Basic
        • Mobile To UAN
        • E-Challan Details
        • Vehicle RC Lite
        • Vehicle RC
        • UAN Advance
    • Face and Document Verification
      • Onsite Verification
      • Face Match
      • Selfie Validation
  • DATA REPOSITORY
    • Search API
  • Business Profile
    • Lookups
      • Email
      • Phone
      • BIN
      • IP
    • Credibility Check
    • Corporate Check
      • Comprehensive Details
    • AML And PEP
    • Court And FIR
    • Cybersafe
  • AML SEARCH
    • Search
    • Search Details
    • Search Details PDF
    • Decision Making
    • Decision Details
  • WEB CRAWLING
    • Initiate Crawl API
    • Status Check API
    • Result API
    • List API
  • Disputes
    • Create Dispute
    • Update Dispute
    • Dispute Details
    • Dispute Level Change
    • Dispute Won
    • Dispute Loss
    • Dispute Reopen
  • MOBILE SDK INTEGRATIONS
    • Android SDK
    • Flutter SDK
    • iOS SDK
  • CLIENT SIDE INTEGRATIONS
    • Javascript Integration
    • Tutelar Error Code
Powered by GitBook
On this page
  • Post Parameters
  • Post parameters description is given below :
  • Sample Post Parameters,
  • Success Response
  • Failure Response
  1. Disputes

Update Dispute

When a client challenges the legitimacy of a transaction made using their registered transacting account, it is referred to as a disputed transaction.

Following the dispute raised in the panel, the client can use the edit option in the action menu to correct any necessary details. Once editing is complete, the details update button will be activated.

PATCH https://stgsecctrl.tutelar.io/api/v1/dispute/update/:disputeId

{
   "success": true,
   "code": 200,
   "message": "Dispute Details updated successfully",
   "data": {}
}
{
    "success": false,
    "code": 300,
    "message": "Update configuration  setting.",
    "data": {}
}
{
   "success": false,
   "code": 300,
   "message": "Unauthorized access",
   "data": {}
}
{
     "success": false,
     "code": 300,
     "message": "Request not found",
     "data": {}
}
{
   "success": false,
   "code": 300,
   "message": "Something went wrong",
   "data": {}
}

Post Parameters

Post parameters description is given below :

Post Parameter
Type
Is mandatory
Description

disputeType

String

No

Dispute type is used to identify what kind of dispute is raised by the customer , various types of disputes are as follows fraud , chargeback , BO, complaint.

internalDueDate

Date

No

Internal due date refers to the final date that a resolution need to be provided for an dispute.

reasonCode

String

No

Send the reason code based on your transaction type. For instance, if you've made a transaction using a Visa card, send the sample code: 10.1

paymentType

String

No

Payment type is used to mention the payment type the customer is used to pay the required amount , payment type includes credit card , debit card ,POS.

acquirerBankCode

String

No

The payment receiver bank is also called an acquirer bank . Every individual bank have an individual code referred to as acquirer bank code.

disputeAmountTdrDetails

Object

No

The TDR type,amount,amount type is using

To calculate the TDR amount from dispute Amount. disputeAmountTdrDetails has fields [type, amountType ( Type as String )].amount data type is Number.

disputeAmountTaxDetails

Object

No

The TAX type, amount, amount type is using To calculate the TAX amount from dispute Amount. disputeAmountTaxDetails has fields [ type, amountType ( Type as String )].amount data type is Number.

Sample Post Parameters,

{
  "transactionDetails": {
    "id": "trans_53146",
    "customerName": "Johnson",
    "customerEmail": "johnson.a@ippopay.com",
    "customerMobile": "9878987677",
    "amount": "1001",
    "transactionDate": "2023-10-11"
  },
  "merchantDetails": {
    "id": "TUT778t78yt",
    "name": "Thiyagarajan",
    "businessName": "Hamam",
    "chargebackEmail": "thiyagarajan.e@ippopay.com",
    "mobile": "9087657767"
  },
  "disputeAmount": "100",
  "disputeAmountTdrDetails": {
    "type": "include",
    "amountType": "price",
    "amount": "50"
  },
  "disputeAmountTaxDetails": {
    "type": "exclude",
    "amountType": "percentage",
    "amount": "50"
  },
  "disputeType": "dispute",
  "internalDueDate": "2023-12-31",
  "dueDate": 9,
  "level": "level_1",
  "paymentType": "cc",
  "acquirerBankCode": "HDFC",
  "remitterBank": "Indian Overseas Bank ",
  "reasonCode": "109",
  "nodalAccountNo": "0989778",
  "gatewayOrderId": "ORD_90045",
  "paymentInstrumentId": "89 09 78",
  "comments": " Transaction issues "
}

Success Response

{
    "success": true,
    "code": 200,
    "message": "Updated successful",
    "data": {}
}

Failure Response

{
   "success": false,
   "code": 300,
   "message": "Please Update general configuration",
   "data": {}
}
{
   "success": false,
   "code": 300,
   "message": "Invalid data received from Dispute type",
   "data": {}
}
{
   "success": false,
   "code": 300,
   "message": "Invalid Date format in Internal Due date",
   "data": {}
}
{
   "success": false,
   "code": 300,
   "message": "Internal due date should be greater than 2024-04-10",
   "data": {}
}
{
   "success": false,
   "code": 300,
   "message": "Invalid reason code.",
   "data": {}
}
{
   "success": false,
   "code": 300,
   "message": "Acquirer bank code should be 4 characters",
   "data": {}
}
{
   "success": false,
   "code": 300,
   "message": "Please add acquirer bank details",
   "data": {}
}
{
   "success": false,
   "code": 300,
   "message": "dispute-tdr type field is missing",
   "data": {}
}
{
   "success": false,
   "code": 300,
   "message": "Invalid data received from dispute-tdr type",
   "data": {}
}
{
   "success": false,
   "code": 300,
   "message": "dispute-tdr amount type field is missing",
   "data": {}
}
{
   "success": false,
   "code": 300,
   "message": "Invalid data received from dispute-tdr amount type",
   "data": {}
}
{
   "success": false,
   "code": 300,
   "message": "Dispute-tdr amount missing",
   "data": {}
}
{
   "success": false,
   "code": 300,
   "message": "Dispute-tdr amount is should be an number",
   "data": {}
}
{
   "success": false,
   "code": 300,
   "message": "Invalid data received from dispute-tax type",
   "data": {}
}
{
   "success": false,
   "code": 300,
   "message": "dispute-tdr amount tax field is missing",
   "data": {}
}
{
   "success": false,
   "code": 300,
   "message": "Invalid data received from dispute-tax type",
   "data": {}
}
{
   "success": false,
   "code": 300,
   "message": "Dispute-tax amount type missing",
   "data": {}
}
{
   "success": false,
   "code": 300,
   "message": "Invalid data received from dispute-tax amount type",
   "data": {}
}
{
   "success": false,
   "code": 300,
   "message": "Dispute-tax amount missing",
   "data": {}
}
{
   "success": false,
   "code": 300,
   "message": "Dispute-tax amount is should be an number",
   "data": {}
}
{
   "success": false,
   "code": 300,
   "message": "Dispute-tdr amount should not be greater than dispute amount",
   "data": {}
}
{
   "success": false,
   "code": 300,
   "message": "Dispute-tax amount should not be greater than dispute amount",
   "data": {}
}
{
   "success": false,
   "code": 300,
   "message": "Total of tax and tdr amount should not be greater than dispute amount",
   "data": {}
}
PreviousCreate DisputeNextDispute Details

Last updated 1 year ago