Provider Integration Guide

Connect your platform to tPay365 as a subscription provider. Receive priority payments from ring-fenced vaults and reduce missed payment rates.

tPay_ID vs API Integration

Providers can integrate in two ways: lightweight tPay_ID linking or full API integration.

tPay_ID Linking

Users share their tPay_ID. You verify and receive guaranteed payments. Zero code changes needed.

API Integration

Full API access for subscription management, payment status, and customer analytics.

Subscription Connect Flow

When a user links your service, tPay365 creates a vault allocation for your subscription amount.

Connect a subscription

http

POST /api/v1/subscriptions/connect HTTP/1.1
Host: api.tpay365.com
Authorization: Bearer sk_live_provider_key
Content-Type: application/json

{
  "provider_id": "netflix_uk",
  "user_tpay_id": "TP-8821-9920",
  "amount": 1599,
  "currency": "GBP",
  "frequency": "MONTHLY",
  "category": "ENTERTAINMENT"
}

Response — 201 Created

json

{
  "subscription_id": "sub_xyz789",
  "status": "active",
  "vault_allocation": {
    "vault_ref": "vault:subscription:uuid-here",
    "amount": 1599,
    "next_payment": "2026-03-01T00:00:00Z"
  }
}

Priority Position

Providers connected via tPay365 receive priority payment positioning. When an employee's salary arrives, ring-fenced vaults are funded before discretionary spending.

Payment guarantee

Subscriptions allocated to vaults are ring-fenced at paycheck time. Providers see a measurable reduction in missed and late payments.