The Faster Payments API

Choose your integration

Two powerful APIs for every use case

Whether you need to automate your own outbound payments or build payment features into your platform for clients, we have you covered.

Business API

Automate outbound payments directly from your Telleroo business account. Create bank transfers, manage recipients, and track transaction statuses, all programmatically.

✓ Send Faster Payments 24/7 including bank holidays
✓ Manage recipients and accounts
✓ Real-time webhooks for payment events
✓ Full sandbox environment for testing
✓ UK (FPS), EUR (SEPA) and USD (ACH) support

View Business API Docs →

Partner API

Build payments into your platform for your clients. Create pay runs awaiting approval in your clients' Telleroo business accounts via OAuth, perfect for SaaS, payroll, and accounting apps.

✓ OAuth 2.0 authorisation flow
✓ Create pay runs on behalf of clients
✓ Approval workflows built in
✓ Webhooks for pay run status updates
✓ Multi-company management

View Partner API Docs →

How it works

Go live in four simple steps

From sandbox to production in as little as a few days. We'll support you every step of the way.

1

Book a discovery call

Tell us about your payment needs and we'll guide you on the best integration approach.

2

Get sandbox access

We set up your sandbox within 1 working day. Test payments, webhooks, and approval flows risk-free.

3

Build your integration

Use our clear docs and RESTful endpoints. Minimal developer effort, most integrations take days, not weeks.

4

Go live

Switch to production keys and start processing real payments. Our team is on hand for support.

API Reference

Clean, RESTful endpoints

Simple, well-documented endpoints for every payment operation. Production at api.telleroo.com and sandbox at sandbox.telleroo.com

Method	Endpoint	Description
GET	/accounts	List all accounts with current balances
GET	/recipients	List all saved payment recipients
POST	/recipients	Create a new payment recipient
GET	/recipients/{id}	Get details for a specific recipient
DELETE	/recipients/{id}	Remove a recipient
POST	/bank_transfers	Create a bank transfer to a saved recipient
POST	/adhoc_bank_transfers	Send a one-off payment without saving the recipient
GET	/transactions	Query transaction history with date filtering
GET	/transactions/{id}	Get full details and status of a single transaction

Method	Endpoint	Description
GET	/companies	List all authorised client companies
GET	/companies/{id}	Get details for a specific company
GET	/accounts	List accounts for an authorised company
POST	/pay_runs	Create a pay run with multiple payments
POST	/pay_runs/{id}/submit	Submit pay run for client approval
GET	/pay_runs/{id}	Check pay run status and payment details

Quick start

Send a payment in a single API call

Create a bank transfer with one POST request. Payments are processed via the UK Faster Payments System and arrive in seconds, 24 hours a day, 365 days a year.

Authentication is simple: include your API token in the request header. Use the sandbox to test before going live.

See full docs →

POST /bank_transfers

curl -X POST https://api.telleroo.com/bank_transfers \
  -H "Authorization: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "acc_abc123",
    "recipient_id": "rec_xyz789",
    "amount": 150000,
    "reference": "Invoice #1042",
    "tag": "supplier-payments"
  }'

# Amount is in pence — 150000 = £1,500.00
# Payment arrives in seconds via Faster Payments

Features

Built for speed, control, and security

⚡

24/7 Faster Payments

Payments arrive almost instantly via the Faster Payments System, even on weekends and bank holidays.

🔐

Granular permissions

Set different approval levels on API keys. Control who can create, approve, and send payments.

🔔

Real-time webhooks

Get instant notifications for payment sent, failed, and credit events. Monitor everything programmatically.

🧪

Full sandbox

Test your entire integration, payments, webhooks, and approval flows, in a risk-free sandbox environment.

🌍

Multi-currency

Send GBP via Faster Payments, EUR via SEPA, and USD via ACH, all from a single API integration.

🔑

Idempotent requests

Prevent duplicate payments with idempotent keys. Safely retry requests without worrying about double-sends.

Use cases

Who uses the Telleroo API?

From payroll platforms to lending companies, our API powers payments across dozens of industries.

💼

Staffing & Payroll

Automate high-volume weekly pay runs for temporary and permanent staff across the UK.

🏦

Lending & Finance

Disburse loan payments and process repayments with full transaction tracking and status updates.

📊

Accounting platforms

Let your clients sync automatically sync invoices and payroll to Telleroo, where they can be processed in a few clicks.

🛡️

Insurance

Process claim payouts and settlements with speed and audit trails built in.

🚚

Logistics

Pay drivers, couriers, and suppliers automatically on delivery confirmation.

🎓

Education

Manage bursary payments, tutor payouts, and bulk refund processing at scale.

Proven at scale

Don't just take our word for it

1000+

Businesses using Telleroo

24/7

Payment processing

<1 day

To access sandbox

99.9%

API uptime

★★★★★

"We've used Telleroo for 2 years and make around 1,000 payroll payments each week to care home staff all over the UK. We automate everything using Telleroo and all I have to do is check, fund and approve pay runs."

Laura Beales

Head of Finance, Florence

FAQs

Frequently asked questions

Connect to our RESTful API to access accounts, payment statuses, recipients, approval workflows, transactions, and more. Payments can be sent 24/7 (even on bank holidays) via the Faster Payments System (FPS). You can also send EUR payments via SEPA and USD payments via ACH.

The Business API lets you automate outbound payments from your own Telleroo account, ideal for businesses processing their own payroll, supplier, or customer payments. The Partner API uses OAuth to let your platform create pay runs in your clients' Telleroo accounts. Perfect for SaaS, accounting, and payroll software.

Our team are happy to discuss commercials as part of the process when you get started with the Telleroo API. Just let us know what volume of payments you expect to process each month and we'll put together a tailored plan.

You can use the Telleroo API to automate Faster Payments in the UK (GBP). You can also convert and send EUR payments via SEPA and USD payments via ACH. Whether you're paying employees, settling invoices, or processing customer payouts, the API handles it all.

Yes. You can test everything in our sandbox before going live, including payment creation, webhooks, and approval flows. The sandbox mirrors production, so you can build with confidence. We'll set it up within 1 working day of your discovery call.

Most integrations go live within days, not weeks. Our API is RESTful with clear documentation, and our team provides hands-on support throughout the process. Complex integrations with custom approval workflows may take a little longer.

Anyone who wants to automate high-volume payouts on behalf of a business. Our API clients span industries such as staffing, lending, payroll, finance, logistics, recycling, insurance, utilities, and education — to name just a few.

Get started

Ready to automate your payments?

Book a discovery call and we'll have your sandbox environment ready within 1 working day. Our team is always on hand to help.

Book a discovery call → Read the docs →

Faster Payments API