Approve dispute amount

After the seller proposes a dispute amount, the buyer will receive a notification to either approve or reject the proposed amount. This negotiation continues until the buyer gives approval or the seller escalates the dispute to resolution.

Once the buyer approves, the dispute is resolved, and any agreed-upon payment is processed to the seller, with the remaining amount refunded to the buyer if applicable.

Approve dispute amount

PATCH {{api_url}}/v1/dispute/{{dispute_id}}/approve-dispute-amount

Headers

NameTypeDescription

Accepts

string

application/json

Authorization

string

your Trustcrow API keys with which you authorize customers.

{
    "status": true,
    "message": "Dispute Amount Approved 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": "APPROVED",
        "dispute_amount": 200,
        "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:34:44.779Z",
        "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/reject-dispute-amount' \
--header 'Content-Type: application/json' \
--header 'Authorization: {{secret_key}}' \
--data '{
    "buyer_id": "524c35c9-ef73-4a4d-a4ab-97146f3cff95"
}'

Last updated