Add dispute amount
In intra-party mediation between the buyer and the seller, the seller will have the chance to negotiate terms with the buyer, including a disputed amount for their service.
Dispute amount cannot be greater than the transaction amount. It is either equal to or less than the amount held in escrow.
Add dispute amount
PATCH {{api_url}}/v1/dispute/{{dispute_id}}/add-dispute-amount
Headers
Name
Type
Description
Accepts
string
application/json
Authorization
string
your Trustcrow API keys with which you authorize customers.
{
"status": true,
"message": "Dispute amount added successfully",
"data": {
"id": "c476096f-ffdc-4107-af5b-2b277bd4c9eb",
"dispute_code": "TRU_DIS_BWMQC7CJX2Z4MJAH",
"description": "string",
"buyer_id": "524c35c9-ef73-4a4d-a4ab-97146f3cff95",
"seller_id": "eeae27bc-3e12-47f4-a6cb-fceaa3013629",
"status": "INTRA_PARTY_MEDIATION",
"dispute_amount_status": "SUBMITTED",
"dispute_amount": 408,
"milestone_id": "c7fc8a6a-4be5-40f1-bd8f-dabc0ce2e7ae",
"is_buyer_evidence_submitted": false,
"is_seller_evidence_submitted": false,
"intra_party_mediation_end_date": "2023-12-31T14:29:48.389Z",
"evidence_submission_end_date": null,
"created_by": "ec5fe1cf-dcf3-48b9-b003-7417fea0c0f1",
"cancellation_agreement_details": null,
"canceled_by": null,
"created_at": "2023-12-28T14:29:48.459Z",
"updated_at": "2023-12-28T15:16:48.681Z",
"buyer": {
"id": "524c35c9-ef73-4a4d-a4ab-97146f3cff95",
"user_id": "369ea20c-212b-4b2a-9f87-31c7b11dec58",
"organisation_id": "7019af1c-5762-443a-880f-6d950f31ce9f",
"role": "SUPER ADMIN",
"created_at": "2023-12-26T09:03:18.782Z",
"updated_at": "2023-12-26T09:03:18.782Z",
"user": {
"id": "369ea20c-212b-4b2a-9f87-31c7b11dec58",
"first_name": "Haleemah",
"last_name": "Opeyemi",
"user_name": "haopho31079",
"email": "haleemahfolag@yopmail.com",
"default_email": "ec5fe1cf-dcf3-48b9-b003-7417fea0c0f1_haleemahfolag@yopmail.com",
"phone": null,
"password": "$2b$10$H0xNaaLKERiHLvWsLQQLXegJtcBZvq64wAgfB5Yo53OzAsa8COM0C",
"is_account_verified": true,
"password_reset": false,
"role": "USER",
"referredById": null,
"referral_code": null,
"clientId": "ec5fe1cf-dcf3-48b9-b003-7417fea0c0f1",
"source": "THIRD_PARTY",
"public_key": null,
"secret_key": null,
"api_enabled": false,
"password_created": false,
"last_logged_in_at": "2023-12-27T18:55:47.527Z",
"created_at": "2023-12-26T09:03:18.766Z",
"updated_at": "2023-12-27T18:55:47.532Z"
}
},
"seller": {
"id": "eeae27bc-3e12-47f4-a6cb-fceaa3013629",
"user_id": "7c4e5b33-eb74-41fd-8f07-230cfaeb2439",
"organisation_id": "9876d61f-ad34-4d5a-be9d-46bee63c8c4a",
"role": "SUPER ADMIN",
"created_at": "2023-12-26T09:56:54.276Z",
"updated_at": "2023-12-26T09:56:54.276Z",
"user": {
"id": "7c4e5b33-eb74-41fd-8f07-230cfaeb2439",
"first_name": "John",
"last_name": "Doe",
"user_name": "jodojd30278",
"email": "joe@yopmail.com",
"default_email": "ec5fe1cf-dcf3-48b9-b003-7417fea0c0f1_joe@yopmail.com",
"phone": null,
"password": "$2b$10$.z0AxFZGE5rNdmxW0IJ3Zuu6TszOe.1Azqyx0RC71uQ20QvX6TTGO",
"is_account_verified": true,
"password_reset": false,
"role": "USER",
"referredById": null,
"referral_code": null,
"clientId": "ec5fe1cf-dcf3-48b9-b003-7417fea0c0f1",
"source": "THIRD_PARTY",
"public_key": null,
"secret_key": null,
"api_enabled": false,
"password_created": false,
"last_logged_in_at": "2023-12-27T17:52:27.017Z",
"created_at": "2023-12-26T09:56:54.249Z",
"updated_at": "2023-12-27T17:52:27.030Z"
}
},
"milestone": {
"id": "c7fc8a6a-4be5-40f1-bd8f-dabc0ce2e7ae",
"title": "testing milestone title",
"description": "testing milestone description",
"amount": 500,
"is_milestone_funded": true,
"position_in_transaction": 1,
"is_delivered": true,
"is_completed": false,
"delivery_rejection_reason": "I do whatever I like",
"is_delivery_rejected": false,
"is_return_proof_sent": false,
"is_return_approved": false,
"is_return_rejected": true,
"due_date_type": "DEADLINE_DATE",
"due_date": "2023-12-31T00:00:00.000Z",
"execution_timeline": null,
"status": "IN_DISPUTE",
"commission_payer": "SELLER_100",
"discount_code": null,
"milestone_fee": 16.25,
"transaction_id": "be8232a0-af40-4dd5-9370-041153200cb9",
"inspection_duration": 2,
"inspection_end_date": "2023-12-30T10:07:53.465Z",
"return_deadline_date": "2023-12-31T10:08:05.830Z",
"current_extension_index": null,
"milestone_escrow_id": "4017ad17-3742-4e7e-9591-9b6c64fe3d95",
"rate_used": 1,
"created_at": "2023-12-27T15:32:44.884Z",
"updated_at": "2023-12-28T10:08:30.979Z",
"transaction": {
"id": "be8232a0-af40-4dd5-9370-041153200cb9",
"title": "sales of team",
"description": "Sales of heavy agricultural produce",
"currency": "NGN",
"location_type": "LOCAL",
"category": "GOODS",
"sub_category": "Food/beverage/agriculture",
"transaction_contract_url": "https://trustcrow-dev-docs.s3.amazonaws.com/",
"status": "MILESTONE_IN_DISPUTE",
"transaction_originator": "BUYER",
"buyer_id": "524c35c9-ef73-4a4d-a4ab-97146f3cff95",
"seller_id": "eeae27bc-3e12-47f4-a6cb-fceaa3013629",
"source": "api",
"clientId": "ec5fe1cf-dcf3-48b9-b003-7417fea0c0f1",
"transaction_amount": 500,
"total_amount_funded": 500,
"total_amount_refunded": 0,
"total_amount_disbursed": 0,
"current_milestone_id": "c7fc8a6a-4be5-40f1-bd8f-dabc0ce2e7ae",
"job_id": null,
"decline_reason": null,
"is_completed": false,
"has_buyer_rated": false,
"on_last_milestone": true,
"has_seller_rated": false,
"discount_code": null,
"declined_at": null,
"approved_at": null,
"created_by": "ec5fe1cf-dcf3-48b9-b003-7417fea0c0f1",
"updated_by": null,
"date_canceled": null,
"created_at": "2023-12-27T15:32:44.884Z",
"updated_at": "2023-12-28T11:01:59.625Z"
},
"milestone_logs": [
{
"id": "440ad061-80c0-4a3f-bde3-5609f53bb09a",
"log_message": "Milestone Due Date set to 2023-12-31T00:00:00.000Z",
"milestone_id": "c7fc8a6a-4be5-40f1-bd8f-dabc0ce2e7ae",
"created_at": "2023-12-28T10:07:22.570Z",
"updated_at": "2023-12-28T10:07:22.570Z"
},
{
"id": "80b958c2-d882-4d57-ba30-3bc97ecd0f01",
"log_message": "Milestone #1 inspection started",
"milestone_id": "c7fc8a6a-4be5-40f1-bd8f-dabc0ce2e7ae",
"created_at": "2023-12-28T10:07:53.475Z",
"updated_at": "2023-12-28T10:07:53.475Z"
},
{
"id": "824d21c1-34d3-4a9e-a495-6acfc9b9dfb4",
"log_message": "Buyer has rejected the delivery of this milestone",
"milestone_id": "c7fc8a6a-4be5-40f1-bd8f-dabc0ce2e7ae",
"created_at": "2023-12-28T10:08:05.832Z",
"updated_at": "2023-12-28T10:08:05.832Z"
},
{
"id": "d42b90bf-5754-454e-8094-b24fad683763",
"log_message": "Milestone 1 delivery returned by buyer,awaiting approval from seller",
"milestone_id": "c7fc8a6a-4be5-40f1-bd8f-dabc0ce2e7ae",
"created_at": "2023-12-28T10:08:05.848Z",
"updated_at": "2023-12-28T10:08:05.848Z"
},
{
"id": "b6d9a8de-2349-4850-abdd-23a34816480b",
"log_message": "Seller has rejected the return of this milestone delivery and a dispute process has been initiated",
"milestone_id": "c7fc8a6a-4be5-40f1-bd8f-dabc0ce2e7ae",
"created_at": "2023-12-28T10:08:15.053Z",
"updated_at": "2023-12-28T10:08:15.053Z"
}
]
}
}
}cURL Request
curl --location --request PATCH 'http://trustcrow-api-sandbox.us-east-1.elasticbeanstalk.com/v1/dispute/c476096f-ffdc-4107-af5b-2b277bd4c9eb/add-dispute-amount' \
--header 'Content-Type: application/json' \
--header 'Authorization: {{secret_key}}' \
--data '{
"dispute_amount": 408,
"seller_id": "eeae27bc-3e12-47f4-a6cb-fceaa3013629"
}'Last updated