Reject item delivery
Once the item has been delivered to the buyer, the buyer is required to accept or reject such item. If rejected, the buyer will be requested to upload proof of item being returned.
When the buyer rejects a delivery, the response parameters;
"is_delivery_rejected" is set to true
"status" shows
DELIVERY_RETURNED_AWAITING_APPROVAL
To reject a milestone
POST {{api_url}}/v1/milestones/{milestone_id}/reject
Query Parameters
Name
Type
Description
milestone_id*
string
specify the milestone id
Headers
Name
Type
Description
Authorization*
string
your Trustcrow API keys to authorize customers
Request Body
Name
Type
Description
buyer_id*
string
input the buyer's ID
{
"status": true,
"message": "Milestone rejected successfully",
"data": {
"id": "a33123ae-8e93-4f58-b380-2010c4bc2e04",
"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": true,
"is_return_proof_sent": false,
"is_return_approved": false,
"is_return_rejected": false,
"due_date_type": "DEADLINE_DATE",
"due_date": "2023-12-31T00:00:00.000Z",
"execution_timeline": null,
"status": "DELIVERY_RETURNED_AWAITING_APPROVAL",
"commission_payer": "SELLER_100",
"discount_code": null,
"milestone_fee": 16.25,
"transaction_id": "8aa7e335-9f9f-4992-816e-acc1ea338850",
"inspection_duration": 2,
"inspection_end_date": "2023-12-30T09:07:36.405Z",
"return_deadline_date": "2023-12-31T09:07:54.671Z",
"current_extension_index": null,
"milestone_escrow_id": "61af5150-b241-4f6f-aca0-e701bbe61806",
"rate_used": 1,
"created_at": "2023-12-28T08:25:33.837Z",
"updated_at": "2023-12-28T09:07:54.714Z",
"transaction": {
"id": "8aa7e335-9f9f-4992-816e-acc1ea338850",
"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_UNDER_INSPECTION",
"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": "a33123ae-8e93-4f58-b380-2010c4bc2e04",
"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-28T08:25:33.837Z",
"updated_at": "2023-12-28T09:07:36.384Z",
"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",
"organisation": {
"id": "7019af1c-5762-443a-880f-6d950f31ce9f",
"name": "Haleemah Opeyemi's Organisation",
"wallet_id": "b78ec8db-4bab-43c3-84a1-a9d55d036d54",
"paystack_customer_code": null,
"account_kyc_type": "INDIVIDUAL",
"is_kyc_completed": true,
"is_kyc_submitted": true,
"is_kyc_approved": true,
"is_kyc_declined": false,
"kyc_decline_reason": null,
"kyc_completed_at": "2023-12-27T18:56:53.228Z",
"created_by": "369ea20c-212b-4b2a-9f87-31c7b11dec58",
"kyc_approved_by": "796171ea-00fe-4894-9626-3245c5581643",
"kyc_declined_by": null,
"location_type": "LOCAL",
"updated_by": null,
"created_at": "2023-12-26T09:03:18.775Z",
"updated_at": "2023-12-27T18:57:16.394Z"
},
"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",
"organisation": {
"id": "9876d61f-ad34-4d5a-be9d-46bee63c8c4a",
"name": "John Doe's Organisation",
"wallet_id": "6ba37133-a54b-42d2-af1d-d20e1ed7a13a",
"paystack_customer_code": null,
"account_kyc_type": "INDIVIDUAL",
"is_kyc_completed": true,
"is_kyc_submitted": true,
"is_kyc_approved": true,
"is_kyc_declined": false,
"kyc_decline_reason": null,
"kyc_completed_at": "2023-12-27T17:54:04.786Z",
"created_by": "7c4e5b33-eb74-41fd-8f07-230cfaeb2439",
"kyc_approved_by": "796171ea-00fe-4894-9626-3245c5581643",
"kyc_declined_by": null,
"location_type": "LOCAL",
"updated_by": null,
"created_at": "2023-12-26T09:56:54.268Z",
"updated_at": "2023-12-27T17:54:35.700Z"
},
"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_escrow": {
"id": "61af5150-b241-4f6f-aca0-e701bbe61806",
"balance": 500,
"created_at": "2023-12-28T08:25:33.837Z",
"updated_at": "2023-12-28T08:28:38.366Z"
}
}
}cURL Request
curl --location 'http://trustcrow-api-sandbox.us-east-1.elasticbeanstalk.com/v1/milestones/a33123ae-8e93-4f58-b380-2010c4bc2e04/reject' \
--header 'Content-Type: application/json' \
--header 'Authorization: SECRET_KEY' \
--data '{
"buyer_id": "369ea20c-212b-4b2a-9f87-31c7b11dec58",
"rejection_reason": "I do whatever I like",
"proofs_of_return": ["https://google.com"]
}'Last updated