For the complete documentation index, see llms.txt. This page is also available as Markdown.
How To - Submit Milestones
Guide Overview
At this point your vendor smart contract should already be deployed and active. The following guide will walk you through how to submit evidence and withdraw a milestone payment.
You will find links to the Milestone Acceptance Form Templates and Milestone Acceptance Form Examples at the bottom of this page.
Process to submit a milestone
Your vendor smart contract commits your project and delivery schedule; milestone name, deliverable, payment date and amount, immutably to the Cardano blockchain. This metadata and any subsequent agreed changes will be publicly available.
1
Step 1: Prepare and Share Your Milestone Acceptance Form
In your agreed communication channel with the Intersect Delivery Assurance team, you must provide a completed Milestone Acceptance Form for each milestone. This must be done on or before the Milestone Completion Date stated in your legal contract.
Best practice tip
It is helpful to prepare a Milestone Acceptance Form for each milestone in advance. Share drafts early and work on them openly with the Delivery Assurance team. They may be able to give feedback throughout the process, not just at the end. This usually speeds up review and acceptance.
The Delivery Assurance team will review your Milestone Acceptance Form and confirm whether the evidence meets the deliverables and acceptance criteria in your contract.
If your Milestone Acceptance Form is accepted
The Delivery Assurance team will host your completed form and give you a link to it.
You will use this link later when submitting evidence on‑chain.
(If agreed in advance, you may host the form yourself and provide the link.)
If your Milestone Acceptance Form is not accepted, or not submitted on time
The Delivery Assurance team will explain why it is not acceptable and tell you what needs to be fixed.
If no Milestone Acceptance Form is provided at all, the Delivery Assurance team will recommend pausing the current milestone and all future milestones.
2
Step 2: Log in to the Smart Contract Administration Dashboard
Log in using the wallet or credential you provided in your legal contract.
3
Step 3: Find Your Vendor Smart Contract
Navigate to your vendor smart contract.
The contract name will usually match (or be a shortened version of) your legal contract name.
If you have several projects, the name may combine multiple project titles.
Longer projects may also be split into several smart contracts, even though you have only one legal contract. These names should be agreed in advance.
Smart contracts where you have available actions will be highlighted.
Open your vendor smart contract and continue to Step 4.
4
Step 4: Submit Your Evidence On‑Chain
Click the “Submit Evidence” button.
A pop‑up form will appear. Complete the fields as follows:
Milestone: Select the milestone this evidence relates to. Some vendors have multiple milestones requiring evidence.
Title: Enter a clear title, including the milestone number and name exactly as written in your legal contract.
Evidence URL: Paste the link provided by the Delivery Assurance team in Step 1. This link must point to your completed Milestone Acceptance Form.
Once finished, click “Submit Evidence”.
You may be asked to sign a transaction to submit the evidence on‑chain.
Important
If you do not submit a Milestone Acceptance Form on or before the Milestone Completion Date, or do not submit evidence at all, your smart contract payment date may be paused.
Many organisations still require invoices. Submit your invoice within 5 working days of the Milestone Completion Date, following your contract instructions.
Failure to submit invoices may also result in payment delays or paused milestones.
5
Step 5: Withdraw Your Available Payments
Once your evidence is submitted, you may choose the option: “Withdraw All Available Payments”
Follow the prompts to withdraw any milestone payments that have reached their payment date.
Important
Withdrawing payments without providing evidence may result in all future milestones being paused.
Additional Information
Where possible, on‑chain smart contracts will be used to manage your project’s treasury funds. The following resources explain how smart contracts work within Intersect’s administration:
