Reject item delivery
Last updated
Was this helpful?
Last updated
Was this helpful?
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 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
POST
{{api_url}}/v1/milestones/{milestone_id}/reject
milestone_id*
string
specify the milestone id
Authorization*
string
your Trustcrow API keys to authorize customers
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 --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"]
}'