Deliver item
Once the milestone has been funded, the seller is expected to deliver the milestone. When a seller ships or deliver a milestone, such seller is expected to notify the escrow system and submit proof of delivery.
To deliver a milestone
POST {{api_url}}/v1/milestones/{milestone_id}/deliver
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 |
|---|---|---|
seller_id* | string | input the seller's ID |
proofs_of_completion* | string | Upload proof of completion |
{
"status": true,
"message": "Milestone delivered successfully",
"data": {
"id": "b3c1349e-04cd-4554-b73e-a224e5f702d7",
"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": 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": "UNDER_INSPECTION",
"commission_payer": "SELLER_100",
"discount_code": null,
"milestone_fee": 16.25,
"transaction_id": "d209c389-45c6-4f78-92c2-26f23db95d96",
"inspection_duration": 2,
"inspection_end_date": "2023-12-29T19:14:07.613Z",
"return_deadline_date": null,
"current_extension_index": null,
"milestone_escrow_id": "d73605dc-467f-46ed-bbd1-9e63154c7ba2",
"rate_used": 1,
"created_at": "2023-12-27T14:48:32.423Z",
"updated_at": "2023-12-27T19:14:07.619Z",
"transaction": {
"id": "d209c389-45c6-4f78-92c2-26f23db95d96",
"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_PROGRESS",
"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": "b3c1349e-04cd-4554-b73e-a224e5f702d7",
"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-27T14:48:32.423Z",
"updated_at": "2023-12-27T19:13:26.439Z",
"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": "d73605dc-467f-46ed-bbd1-9e63154c7ba2",
"balance": 500,
"created_at": "2023-12-27T14:48:32.423Z",
"updated_at": "2023-12-27T19:13:26.454Z"
}
}
}cURL Request
curl --location 'http://trustcrow-api-sandbox.us-east-1.elasticbeanstalk.com/v1/milestones/b3c1349e-04cd-4554-b73e-a224e5f702d7/deliver' \
--header 'Content-Type: application/json' \
--header 'Authorization: {{secret_key}}' \
--data '{
"seller_id": "7c4e5b33-eb74-41fd-8f07-230cfaeb2439",
"proofs_of_completion": ["https://google.com"]
}'Only when a milestone has been funded does the buyer protection begins, and the seller is instructed to go ahead and ship the products or service.
The upload endpoint can be used to upload the file for the proof of completion.
After an item has been delivered, status of the milestone transaction changes to "UNDER_INSPECTION".
Last updated