Trustcrow API v1
  • Introduction
  • Authentication
  • Errors
  • API Reference
    • User Management
      • Create a user
      • Fetch users
      • Fetch user's wallet
    • Transaction
      • Create a transaction
      • Fetch transactions
      • Fetch milestones
      • Fund milestone
      • Deliver item
      • Accept item delivery
      • Reject item delivery
      • Approve returned item
      • Disapprove returned item
    • Dispute Management
      • Create a dispute
      • Fetch dispute
      • Add dispute amount
      • Approve dispute amount
      • Disapprove dispute amount
    • Disbursement
    • Other tools
      • Bank verification
      • File Upload
Powered by GitBook
On this page
  • Add dispute amount
  • cURL Request

Was this helpful?

  1. API Reference
  2. Dispute Management

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"
}'
PreviousFetch disputeNextApprove dispute amount

Last updated 1 year ago

Was this helpful?