Create Dispute

post

https://api.cloud.mbanq.com/v1/dispute

To create a new dispute, you need to submit the workflow details along with the reason identifier.
The required information should be provided as key-value pairs. Use this API to create a new dispute. Provide necessary details such as reasonIdentifier, accountType, and accountId.
Post a dispute reason, it should be associated with a payment rail as each payment rail can have its own dispute reasons and its corresponding workflows.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

reasonIdentifier

string

required

The unique identifier for the dispute reason.
Example: POS_CANCELLATION

transactions

array of objects

required

transactions*

accountType

string

required

Defaults to DEPOSIT

The type of account associated with the dispute.
Valid account types include CREDIT and DEPOSIT

accountId

integer

required

The unique identifier of the account.
Example: 10555

dateOfDispute

date

The date when the dispute was created.
This field is optional and defaults to the time the dispute is created.
Example: 2024-02-07

workflowData

array of objects

Workflow array of fieldIdentifier and value pairs for questionnaire to be answered.
Requirement based on the field configuration from Dispute Reason Workflow API

workflowData

Headers

tenantId

string

required

Defaults to z01j3e71zd6zkq908vyf5861a8

The ID of your banking instance visible in the MBANQ Console.

Response

Language

Credentials

Bearer

JWT

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200The Dispute is created successfully.