Dispute Resolution

Opening a dispute

If the payer is not satisfied with a transaction, the payer can open a dispute by calling the endpoint below:

post
Opening a dispute

https://api.vesicash.com/disputes/create
Open a dispute for a transaction or a milestone
Request
Response
Path Parameters
transaction_uuid
required
string
The UUID of the transaction
Headers
authorization
required
string
Bearer <access_token>
Form Data Parameters
user_id
required
integer
The ID of the recipient of the transaction.
type
required
string
The type of dispute. Possible values are: 'Item not as described', 'Delivery not received or late', 'Delivery Incomplete'.
description
required
string
A description of what the dispute is about
milestone_id
optional
integer
The ID of the milestone to open dispute for. Required if dispute is for a milestone.
image
optional
string
An image showing proof of the dispute description or type. accompany the dispute description or
200: OK
{
"data": {
"id": 1,
"uuid": "1f297d52-5850-456f-b6eb-7cdd2ad9445f",
"user": {
"id": 4,
"uuid": "cad8580a-c6e3-44e4-83ca-25db675afbc1",
"firstname": "James",
"lastname": "Foss",
"phone": "07032047179",
"email": "jamesfoss@example.com",
"profile": {
"address": null,
"state": null,
"city": null,
"country": null
},
"created_at": "2019-03-28 13:23:37",
"updated_at": "2019-03-28 13:23:37"
},
"type": "Delivery Incomplete",
"description": "My item was not completely delivered.",
"dispute_no": "082313211805",
"image": null,
"status": true,
"is_resolved": false,
"is_refund": false,
"created_at": "2019-04-05 16:47:06",
"updated_at": "2019-04-05 16:47:06"
}
}
‚Äč

Resolving a Dispute

When both seller and buyer have amicably come to an understanding and have resolved their dispute, the buyer (who created the dispute) is expected to signify by 'marking it as resolved' using the endpoint below:

post
Resolving a Dispute

https://api.vesicash.com/disputes/{uuid}/resolve
Request
Response
Path Parameters
uuid
required
string
The UUID of the dispute
Headers
Authorization
required
string
Bearer <access_token>
Form Data Parameters
user_id
required
integer
The ID of the person who created the dispute. Note: Usually the buyer.
200: OK
{
"data": {
"id": 6,
"uuid": "618e72b2-73b2-4348-94e7-e74c623ca6d1",
"user": {
"id": 53,
"uuid": "5a1a8213-0f60-49f6-a725-b6724656f08d",
"firstname": "new_user2",
"lastname": "from_api2",
"phone": "07034719896",
"email": "faithapi@ehi.com",
"user_type": "personal",
"account_balance": "0.00",
"escrow_balance": "0.00",
"profile": {
"address": null,
"state": null,
"city": null,
"country": null
},
"created_at": "2019-05-21 09:41:11",
"updated_at": "2019-05-21 09:41:11"
},
"type": "Delivery Incomplete",
"description": "Third another api dispute",
"dispute_no": "457016264190",
"image": null,
"status": true,
"is_resolved": true,
"created_at": "2019-05-22 11:04:58",
"updated_at": "2019-05-22 15:36:48"
}
}