Employer Integration Guide
Connect your payroll system to tPay365. This guide covers HRIS integration methods, BACS file uploads, sync modes, and employee enrolment management.
Integration Methods
tPay365 supports four integration paths. Choose the one that matches your payroll system.
Workday
API connector — real-time sync via Workday Integration Cloud
ADP
Webhook + file ingestion — event-driven with BACS fallback
Xero
OAuth + payroll sync — OAuth 2.0 connected app with payroll API
CSV Upload
Universal fallback — manual or scheduled CSV upload
BACS File Upload
Upload Standard 18 BACS files directly. The parser handles fixed-width records, validates checksums, and extracts payment instructions.
POST /api/v1/payroll/bacs/upload HTTP/1.1
Host: api.tpay365.com
Authorization: Bearer sk_live_abc123
Content-Type: multipart/form-data
--boundary
Content-Disposition: form-data; name="file"; filename="payroll_feb2026.bacs"
Content-Type: application/octet-stream
[BACS file contents]
--boundary--File requirements
Sync Modes
Choose between real-time and batch sync depending on your payroll cycle.
| Mode | Latency | Best For |
|---|---|---|
| Real-time | <200ms | API-connected HRIS |
| Webhook | <5s | Event-driven systems |
| Batch | Scheduled | CSV/BACS file uploads |
Employee Enrolment
Employees must complete an activation gate before their salary can be orchestrated. The gate verifies identity, bank details, and consent.
{
"employee_id": "emp_8821-9920",
"activation_status": "completed",
"gates_passed": [
"identity_verified",
"bank_details_confirmed",
"consent_signed",
"employer_approved"
],
"activated_at": "2026-02-10T09:15:00Z"
}