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
  • Approve dispute amount
  • cURL Request

Was this helpful?

  1. API Reference
  2. Dispute Management

Approve dispute amount

PreviousAdd dispute amountNextDisapprove dispute amount

Last updated 1 year ago

Was this helpful?

After the seller proposes a dispute amount, the buyer will receive a notification to either approve or 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

Name
Type
Description

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"
}'
reject