BetaYou're exploring an early version of tPay365. Features and content may change as we refine the experience.

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.

Upload BACS file
http
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

BACS files must be Standard 18 format with exactly 100-character records. Maximum file size is 10 MB with up to 10,000 records per file.

Sync Modes

Choose between real-time and batch sync depending on your payroll cycle.

ModeLatencyBest For
Real-time<200msAPI-connected HRIS
Webhook<5sEvent-driven systems
BatchScheduledCSV/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.

Activation gate response
json
{
  "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"
}