Skip to main content
← Back to Documentation

Project Workflow

Popular

Accepting projects, delivering work, and getting paid with payment protection

Last updated Jan 25, 2025 • 15 min read

The Complete Project Lifecycle

Understanding the end-to-end project workflow helps you navigate each stage smoothly and ensures you get paid on time.

Project Status Timeline

1
PROPOSAL_PENDING7-day deadline

Client sent you a proposal. Review details and accept/decline within 7 days.

2
ACCEPTEDPayment processing

You accepted! Client completes payment, funds are secured with payment protection.

3
ACTIVEWork in progress

Payment secured with payment protection. Start working and communicate with client.

4
DELIVEREDAwaiting client review

You uploaded deliverables. Client has 5 days to review and approve.

5
PENDING_REVIEW5-day auto-approval window

Client reviewing your work. Auto-approves after 5 days if no action.

COMPLETEDPayment released

Client approved! Payment released to your Stripe account.

7 Days

To accept proposal

5 Days

Auto-approval window

2-5 Days

Payout processing time

Accepting Project Proposals

When a client hires you, you'll receive a proposal email. Here's how to review and respond.

1

You Receive Proposal Email

Subject: "New Project Proposal from [Client Name]"

Email includes:
• Client name and profile link
• Project title and full description
• Payment amount (already secured)
• Deadline/timeline
• Direct link to accept or decline
• 7-day response deadline
2

Review Proposal Page

Click the email link to view full project details

✓ Check These Details:
Project scope matches your skills
Payment amount is fair for work
Deadline is realistic and achievable
Client has good reviews (if available)
3

Make Your Decision

Accept Project
• Project status → ACCEPTED
• Client pays, funds are secured
• You can start work immediately
• Appears in your dashboard
Decline Project
• Provide optional decline reason
• Client gets notification
• No penalty to your profile
• Can suggest another freelancer
7-Day Deadline

If you don't respond within 7 days, the proposal automatically expires and the client receives a refund. No penalty to your profile, but it may affect your response time metric.

Starting Work

Once you accept and the client pays, the project status becomes ACTIVE and you can begin work.

Your Project Dashboard

Access your active project from Dashboard → Projects. Each project card shows:

Project Details

Title, description, client name, status badge

Payment Info

Secured amount, currency, payment method

Timeline

Deadline, days remaining, progress indicator

Actions

Message client, upload files, request extension

Communicating with Client

Project Messages

Built-in messaging system for project-specific communication. All messages are logged and visible to both parties.

Email Notifications

You'll receive email alerts for: client messages, revision requests, deadline reminders, approval notifications.

Video Calls (PRO)

PRO members can schedule HD video calls directly within PayHeld for project discussions and demos.

Best Practices for Active Projects

Message client within 24 hours of acceptance
Clarify any unclear requirements early
Provide progress updates every 2-3 days
Flag potential delays immediately
Ask questions via project messages (logged)
Save all work files with organized naming

Delivering Your Work

When your work is complete, use the project page to upload deliverables and submit for client review.

Delivery Process

1
Upload Files

Click "Upload Deliverables" on project page. Drag & drop files or browse. Supports all file types, max 100MB per file.

2
Add Delivery Message

Explain what you're delivering, highlight key features, provide usage instructions. This helps client understand your work.

3
Optional: Add Screen Recording

For web/app projects, upload a screen recording showing how it works. Reduces questions and speeds up approval.

4
Click "Submit for Review"

Status changes to DELIVERED → PENDING_REVIEW. Client receives email notification and has 5 days to review.

File Upload Guidelines

✓ Accepted Formats
• Documents: PDF, DOCX, TXT, MD
• Images: JPG, PNG, SVG, WebP
• Design: PSD, AI, XD, SKETCH, FIGMA
• Code: ZIP, RAR, GitHub links
• Video: MP4, MOV, AVI (max 500MB)
✗ Not Allowed
• Executable files (.exe, .bat, .sh)
• Files over 100MB (use Google Drive link)
• Copyrighted content without license
• Malware or suspicious files

Delivery Best Practices

Organize Files Clearly: Use folders like "Final Files", "Source Files", "Documentation"
Include README: Add a README.txt with setup instructions, dependencies, and usage guide
Test Everything: Double-check all files work before uploading. Test on clean environment.
Write Clear Message: Explain what's included, how to use it, and next steps for client

Client Review & Approval

After you deliver, the client has 5 days to review your work and either approve it or request revisions.

5-Day Auto-Approval Window

This is PayHeld's protection for freelancers. If the client doesn't review within 5 days, the project automatically approves and payment is released.

How It Works:
Day 0: You submit deliverables → status becomes PENDING_REVIEW
Day 1-4: Client can review, approve, or request revisions
Day 4: Client receives reminder email
Day 5: Auto-approval! Payment released automatically

What Clients Can Do During Review

Approve Work
• Status → COMPLETED
• Payment released immediately
• Client can leave review
• Project closes successfully
Request Revisions
• Client explains what needs fixing
• You receive revision request email
• Make changes and re-upload
• New 5-day review period starts

What Happens After Approval

Step 1: Payment Released

Funds automatically transferred to your Stripe Connect account

Step 2: Email Notification

You receive "Payment Processed" email with payout details

Step 3: Review System

Client can leave review; you can respond and rate client

Getting Paid with Payment Protection

PayHeld uses payment protection to ensure you get paid for completed work. Here's how payment release works.

Payment Protection Timeline

When You Accept Project

Client pays via Stripe → Funds held securely by PayHeld → You see "Payment Secured" status

While You Work (ACTIVE)

Funds remain secured → Protected from chargebacks → Client cannot withdraw → You're guaranteed payment if you deliver

After Client Approves (or Auto-Approval)

Payment released → Stripe processes transfer to your Connect account → Email notification sent → 2-5 business days to bank

Payout Methods & Timeline

Standard Payout (Free)
• 2-5 business days to your bank
• No additional fees
• Automatic via Stripe Connect
• Email confirmation when deposited
Instant Payout (PRO/BUSINESS)
• Under 30 minutes to your bank
• 1% fee (max $10)
• Available for eligible accounts
• Request from Earnings page
Note: Stripe Connect must be fully verified to receive payouts. Complete verification in Settings → Payments.

Your Payment Is Protected

Client can't withdraw funds once secured
Auto-approval ensures you get paid even if client disappears
Dispute resolution if client unfairly rejects work
PayHeld guarantees payment for completed work

Revisions & Changes

If the client requests changes during the review period, here's how to handle revisions professionally.

Revision Request Flow

1
Client Requests Revision

Client clicks "Request Revisions" and provides detailed feedback on what needs to change. You receive email + in-app notification.

2
Review Feedback

Read revision request carefully. If anything is unclear, message client for clarification before starting changes.

3
Make Changes

Complete requested revisions. Document what you changed in your delivery message for transparency.

4
Re-Submit Work

Upload revised files → Status back to PENDING_REVIEW → New 5-day approval window starts

Handling Revisions Professionally

✓ Do This
• Respond within 24 hours acknowledging request
• Ask clarifying questions if feedback is vague
• Complete revisions within reasonable timeframe
• Document all changes in delivery message
• Stay professional and solution-focused
✗ Don't Do This
• Ignore revision requests
• Get defensive or argue with client
• Rush revisions without understanding feedback
• Charge extra without prior agreement
• Deliver same work without changes
Revision Policy

By default, projects include unlimited revisions unless otherwise specified in the project description. However, revisions must be: (1) within the original scope of work, (2) reasonable and specific, (3) not completely different work. If a client requests out-of-scope changes, you can decline and suggest a new project.

Milestones for Large Projects

For complex or long-term projects, you can break work into milestones with payment released after each stage.

What Are Milestones?

Milestones split a project into phases, each with specific deliverables and payment amounts. Benefits:

For Freelancers
• Get paid progressively as you complete work
• Reduces risk on large projects
• Clear progress tracking
• Easier to manage scope
For Clients
• Pay incrementally, not all upfront
• Review work at each stage
• Request changes per milestone
• Better budget control

How Milestone-Based Projects Work

Example: Website Design Project ($3,000)
Milestone 1: Wireframes & Mockups$800
Milestone 2: Homepage Design$1,000
Milestone 3: Inner Pages Design$800
Milestone 4: Responsive & Final Revisions$400

Milestone Delivery Process

Complete Milestone: Deliver work for current milestone only (not the entire project)
Client Reviews: 5-day approval window per milestone (same as regular projects)
Payment Released: After milestone approval, that portion of the secured funds is released
Next Milestone: Move to next phase, repeat process until project complete

Best Practices for Success

Communication

Respond to messages within 24 hours
Send weekly progress updates
Use project messages (not external email)
Set clear expectations upfront

Time Management

Start work within 48 hours of acceptance
Deliver 1-2 days before deadline
Request extensions early if needed
Build buffer time for revisions

Quality Control

Self-review before submitting
Test all files on clean environment
Include documentation/README
Exceed client expectations

Professionalism

Maintain respectful tone always
Handle criticism constructively
Don't make promises you can't keep
Respect client confidentiality

Frequently Asked Questions

Ready to Start Your First Project?

Now that you understand the workflow, check your dashboard for pending proposals or browse clients looking for freelancers.

Project Workflow | PayHeld Documentation