Accept item delivery
Once the item has been delivered to the buyer, the buyer is required to accept or reject such item. If accepted, the fund will be released automatically to the seller's account.
When the buyer accepts a delivery, the response parameters;
"is_completed" is set to true
"status" shows completed
To accept a milestone
POST {{api_url}}/v1/milestones/{milestone_id}/approve
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 approved successfully",
"data": {
"id": "78f57126-341f-4d94-934e-cca8833f7013",
"title": "testing milestone title",
"description": "testing milestone description",
"amount": 500,
"is_milestone_funded": true,
"position_in_transaction": 1,
"is_delivered": true,
"is_completed": true,
"delivery_rejection_reason": null,
"is_delivery_rejected": false,
"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": "COMPLETED",
"commission_payer": "SELLER_100",
"discount_code": null,
"milestone_fee": 16.25,
"transaction_id": "a9ce3351-b4b3-4e06-831c-49aae3f9b2ed",
"inspection_duration": 2,
"inspection_end_date": "2023-12-29T17:50:33.793Z",
"return_deadline_date": null,
"current_extension_index": null,
"milestone_escrow_id": "db057a5d-cdd4-433d-8328-6840c20ebe73",
"rate_used": 1,
"created_at": "2023-12-27T17:48:32.226Z",
"updated_at": "2023-12-27T17:50:47.393Z",
"transaction": {
"id": "a9ce3351-b4b3-4e06-831c-49aae3f9b2ed",
"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": "78f57126-341f-4d94-934e-cca8833f7013",
"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-27T17:48:32.226Z",
"updated_at": "2023-12-27T17:50:33.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",
"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": null,
"is_kyc_completed": false,
"is_kyc_submitted": false,
"is_kyc_approved": false,
"is_kyc_declined": false,
"kyc_decline_reason": null,
"kyc_completed_at": null,
"created_by": "369ea20c-212b-4b2a-9f87-31c7b11dec58",
"kyc_approved_by": null,
"kyc_declined_by": null,
"location_type": "LOCAL",
"updated_by": null,
"created_at": "2023-12-26T09:03:18.775Z",
"updated_at": "2023-12-26T09:03:18.795Z"
},
"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": null,
"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": null,
"created_at": "2023-12-26T09:03:18.766Z",
"updated_at": "2023-12-26T09:03:18.766Z"
}
},
"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": null,
"is_kyc_completed": false,
"is_kyc_submitted": false,
"is_kyc_approved": false,
"is_kyc_declined": false,
"kyc_decline_reason": null,
"kyc_completed_at": null,
"created_by": "7c4e5b33-eb74-41fd-8f07-230cfaeb2439",
"kyc_approved_by": null,
"kyc_declined_by": null,
"location_type": "LOCAL",
"updated_by": null,
"created_at": "2023-12-26T09:56:54.268Z",
"updated_at": "2023-12-26T09:56:54.292Z"
},
"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-27T15:45:57.265Z",
"created_at": "2023-12-26T09:56:54.249Z",
"updated_at": "2023-12-27T15:45:57.275Z"
}
}
},
"milestone_escrow": {
"id": "db057a5d-cdd4-433d-8328-6840c20ebe73",
"balance": 0,
"created_at": "2023-12-27T17:48:32.226Z",
"updated_at": "2023-12-27T17:50:47.393Z"
}
}
}cURL Request
curl --location 'http://trustcrow-api-sandbox.us-east-1.elasticbeanstalk.com/v1/milestones/78f57126-341f-4d94-934e-cca8833f7013/approve' \
--header 'Content-Type: application/json' \
--header 'Authorization: {{secret_key}}' \
--data '{
"buyer_id": "369ea20c-212b-4b2a-9f87-31c7b11dec58"
}'Last updated
Was this helpful?