Dispute Management

Sometimes, disputes may arise in a transaction so we have made provision for businesses who integrate our escrow API to monitor disputes that arises in their customers transactions.

post
create a dispute

https://api.vesicash.com/v1/transactions/dispute
Request
Response
Request
Headers
Accept
required
string
application/json
V-PRIVATE-KEY
required
string
your vesicash private key
Form Data Parameters
transaction_id
required
string
The id of that transaction.
reason
optional
string
The reason for the dispute.
dispute_status
optional
string
The dispute status. For example "open"
Response
200: OK
{
"status": "ok",
"code": 200,
"message": "Transaction Disputed",
"data": null
}

For example, you can a make a post request to the endpoint above and pass in the json data below to create a dispute for a transaction.

{
"transaction_id":"QvC8epu9UT8OtTCCjmQI",
"reason":"I am no longer interested.",
"dispute_status":"open"
}

Similarly, you can update the status of a dispute using the endpoint below

post
update a dispute

https://api.vesicash.com/v1/transactions/dispute/update
Request
Response
Request
Headers
Accept
required
string
application/json
V-PRIVATE-KEY
required
string
your vesicash private key
Form Data Parameters
transaction_id
required
string
The id of that transaction.
decision
optional
string
The decision that was made concerning the dispute.
dispute_status
optional
string
The dispute status. For example "resolved"
Response
200: OK
{
"status": "ok",
"code": 200,
"message": "Transaction Disputed",
"data": null
}

For example, you can a make a post request to the endpoint above and pass in the json data below to create a dispute for a transaction.

{
"transaction_id":"QvC8epu9UT8OtTCCjmQI",
"decision":"The buyer has been refunded",
"dispute_status":"resolved"
}

Finally, you can list all the disputes that your customers have created using the endpoint below:

post
List disputes created by your customers

https://api.vesicash.com/v1/admin/business/customers/disputes
Request
Response
Request
Headers
Content-Type
optional
string
application/json
V-PRIVATE-KEY
optional
string
your vesicash private key
Form Data Parameters
business_id
required
string
The id of that business.
Response
200: OK
{
"status": "ok",
"code": 200,
"message": "Data Retrieved",
"data": [
{
"dispute_id": "IntV313tYRf8jLnf",
"transaction_id": "QvC8epu9UT8OtTCCjmQI",
"reason": "I don't like the item",
"dispute_status": "open",
"decision": null,
"mediator_id": null,
"created_at": "2020-07-10T13:05:49.000000Z"
},
{
"dispute_id": "s1Edcb5arIbukYJw",
"transaction_id": "QvC8epu9UT8OtTCCjmQI",
"reason": "The buyer has been refunded",
"dispute_status": "closed",
"decision": "completed",
"mediator_id": null,
"created_at": "2020-05-01T14:57:40.000000Z"
},
{
"dispute_id": "ZcpW5dsupIIJ8uK9",
"transaction_id": "QvC8epu9UT8OtTCCjmQI",
"reason": null,
"dispute_status": "closed",
"decision": "completed",
"mediator_id": null,
"created_at": "2020-05-01T14:58:02.000000Z"
}
]
}