---
created: 2026-03-12
source: Rivet
tags: [agent-archive, rivet]
---

# Payroll Integration Research: Xero & MYOB for RateRight

## Executive Summary

After researching both platforms, **I recommend NOT building payroll integrations at this time**. The construction industry has fragmented payroll needs, low switching costs between platforms, and contractors are generally satisfied with handling their own payroll. This would be a significant engineering investment with unclear ROI.

## 1. Xero API Capabilities for Construction Payroll

### Key Features
- **Payroll AU API** specifically designed for Australian payroll requirements
- **Single Touch Payroll (STP) compliance** built-in
- **Superannuation management** with SuperStream compliance
- **Award interpretation** for 120+ modern awards (including construction)
- **Timesheet integration** capabilities
- **Leave management** system
- **Payslip generation and distribution**

### Technical Requirements
- **OAuth 2.0 authentication** required
- **Rate limiting**: 60 calls per minute for payroll endpoints
- **Webhook support** for real-time updates
- **RESTful API** with JSON responses
- **Multi-tenancy support** for managing multiple organizations

### Construction-Specific Features
- Supports complex pay rates for different construction awards
- Handles site allowances and construction-specific deductions
- Integration with job costing systems
- Support for subcontractor payments (though not full payroll)

## 2. MYOB API Capabilities and Market Position

### Key Features
- **Built-in payroll functionality** (not an add-on like Xero)
- **120+ modern awards** compliance including construction
- **Advanced rostering and workforce management**
- **Integrated with MYOB Business management suite**
- **Enterprise-grade solutions** (PayGlobal, Acumatica)
- **Strong compliance focus** for Australian regulations

### Market Share
- **20-25% market share** in Australian small business accounting
- **Stronger presence in mid-market** (20-1000+ employees)
- **Particularly popular in construction** due to built-in awards
- **1 million+ users** across Australia and New Zealand

### Technical Requirements
- **OAuth 2.0 authentication**
- **Granular data scopes** including `sme-payroll`
- **RESTful API** with comprehensive endpoints
- **Webhook support** for event notifications
- **Rate limiting** based on subscription tier

## 3. Value Proposition Analysis

### Current State
RateRight contractors currently handle their own payroll, which means:
- They have existing systems and processes
- They've invested time in learning their chosen platform
- They maintain direct relationships with their payroll providers
- They have established workflows with their accountants

### Potential Value Adds
1. **Streamlined onboarding** - New contractors could set up payroll during RateRight registration
2. **Integrated job costing** - Link payroll directly to RateRight projects
3. **Simplified compliance** - Automated reporting for construction-specific requirements
4. **Bulk processing** - Handle payroll for multiple contractors simultaneously
5. **Negotiated rates** - Volume discounts from platform providers

### Reality Check
After researching forums and industry discussions:
- Most contractors are **satisfied with their current setup**
- **Low switching motivation** - payroll is "set and forget"
- **High trust requirements** - unwilling to change payroll systems lightly
- **Accountant relationships** - many rely on accountant recommendations
- **Fragmented preferences** - no clear winner between Xero/MYOB

## 4. Technical Integration Requirements

### Common Requirements (Both Platforms)
1. **OAuth 2.0 implementation** with refresh token management
2. **Webhook endpoints** for real-time updates
3. **Rate limiting compliance** and retry logic
4. **Data mapping** between RateRight and payroll systems
5. **Error handling** for payroll-specific validation
6. **Audit logging** for compliance requirements

### RateRight-Specific Integration Points
1. **Contractor onboarding** → Employee/contractor creation in payroll
2. **Project/job data** → Job costing allocation
3. **Time tracking** → Timesheet import
4. **Payment data** → Pay run integration
5. **Compliance reporting** → Construction industry-specific requirements

### Development Effort Estimate
- **Backend API integration**: 3-4 weeks
- **Frontend UI for payroll management**: 2-3 weeks
- **Testing and compliance validation**: 2-3 weeks
- **Documentation and training**: 1-2 weeks
- **Total**: 8-12 weeks of development time

## 5. Recommendation: DO NOT BUILD

### Reasons to Delay

1. **Low User Demand**
   - No clear customer requests for this feature
   - Contractors satisfied with current arrangements
   - High switching barriers for critical business systems

2. **Fragmented Market**
   - No clear winner between Xero (60% share) and MYOB (20-25% share)
   - Would need to integrate both for full coverage
   - Additional platforms (QuickBooks, Reckon, etc.) would eventually be requested

3. **High Implementation Cost**
   - 8-12 weeks of development time
   - Ongoing maintenance for two APIs
   - Compliance updates required regularly
   - Support burden for payroll-related issues

4. **Low Differentiation Value**
   - Doesn't solve a core RateRight problem
   - Doesn't improve the marketplace matching experience
   - Would be a "nice to have" rather than competitive advantage

5. **Regulatory Risk**
   - Payroll compliance is complex and changes frequently
   - Potential liability for payroll errors
   - Would need ongoing compliance monitoring

### Alternative Recommendations

1. **Partner with payroll providers** for referral relationships
2. **Create educational content** about payroll best practices
3. **Integrate with job costing tools** instead of payroll directly
4. **Focus on core marketplace features** that drive user value
5. **Revisit in 12 months** if customer demand emerges

### Conclusion

Payroll integration would be a significant distraction from RateRight's core mission of connecting contractors with construction projects. The construction industry has diverse, established payroll preferences, and contractors are generally satisfied managing this themselves. This feature would consume substantial development resources without clear ROI or competitive advantage.

**Recommendation: Never build - focus on core marketplace features instead.**