Developer guide: EFT payments in Canada

EFT API Canada: send and receive EFT payments from your code

An EFT API lets your software send and collect Canadian electronic funds transfers without building bank files by hand. TIB Finance, the Canadian sovereign payment processor headquartered in Montréal, gives you one EFT API to pay suppliers and employees, debit customers by pre-authorized debit and track every transfer by webhook. Below: how EFT works in Canada, then how to integrate it with TIB.

Updated November 22, 2026 • PSP registered with the Bank of Canada • 1,000+ businesses • PCI DSS Level 1

The basics

What is an EFT payment in Canada?

An EFT (electronic funds transfer) moves money directly from one Canadian bank account to another. Payments Canada's rules call it an Automated Funds Transfer (AFT): a credit or a debit exchanged between financial institutions in a file that follows Standard 005, then cleared and settled through the Automated Clearing Settlement System (ACSS) under Rule F1. Many people call it "Canada's ACH" (here is how EFT and ACH differ).

  • EFT credit (direct deposit). You push money into an account: payroll, supplier payments, refunds, commissions, payouts.
  • EFT debit (pre-authorized debit, PAD). You pull money from a payer's account with the payer's signed authorization, under Payments Canada Rule H1. See our PAD API guide and the PAD rules in Canada.

An EFT API puts both directions behind a few calls. Your application says who to pay or debit, how much and when. The processor builds the bank files, transmits them, follows each transaction and tells you what happened.

Under the hood

How does a CPA-005 EFT file work?

Financial institutions exchange EFT transactions in fixed-length files defined by Payments Canada Standard 005, usually called the CPA-005 format. Every logical record is 1,464 characters long, and its first character gives its type.

RecordWhat it carries
A (header)First record, once per file: originator's ID, file creation number, creation date, destination data centre, currency.
C (credit)Credit transactions: money deposited into payees' accounts.
D (debit)Debit transactions: pre-authorized debits from payors' accounts.
E / FThe originator's reversal of a C or D transaction.
I / JReturns sent back by the returning financial institution.
Z (trailer)Last record: total number and value of the file's debits and credits.

Each C or D record holds up to six transaction segments. A segment carries the transaction type code, amount, date funds are to be available, institution and transit numbers, account number, the originator's short name (15 characters) and long name (30), the payee or payor name (30), a cross-reference number and the account for returns.

Building, numbering and balancing these files is exactly the work an EFT API takes off your plate. And if your system already produces CPA-005 files, TIB Finance accepts them as they are.

Timing

How long does an EFT take in Canada?

Under Rule F1, financial institutions exchange EFT files on business days, in three exchange periods that close at 9:30 a.m., 4:30 p.m. and 9:00 p.m. Eastern Time.

  • Credits. When the receiving branch has serviceability code "0", funds must be available within 2 hours of the exchange deadline. A credit received the business day before its due date must be available at the opening of business on the due date.
  • Debits. A debit cannot be delivered before its due date. That is why you schedule a PAD for a date, not for "now".
  • Returns. An institution must return a transaction no later than the business day after the first unit able to decide on it receives it.

With TIB Finance, EFT deposits land in 1 to 2 business days. When a payment cannot wait, TIB's proprietary instant payment system moves the money in seconds (instant payments). Holidays and file deadlines are covered in our guide to EFT cut-off times.

Returns

What do EFT return codes mean?

When an EFT fails, the financial institution sends it back with a three-digit reason code defined in Payments Canada Standard 007. The ones you will meet most often:

CodeMeaningWhat your code should do
901NSF, non-sufficient funds (debits only)Re-present once, within 30 calendar days of the return. A PAD must keep the same amount.
902Account not foundAsk the customer to confirm the institution, transit and account numbers.
905Account closedCollect new banking information.
908Funds not cleared (debits only)Same rule as 901: one re-presentment within 30 calendar days.
912Invalid or incorrect account numberCorrect the account number.
915 to 921Payor-initiated returns of a debit: no agreement, not according to agreement, agreement revoked, no confirmation or pre-notificationReview the PAD agreement and the notices you sent.

Under Rule H1, a payor can claim a refund of a PAD within 90 calendar days for a personal PAD and 10 business days for a business PAD. Full list: EFT return codes. Next steps after a failed debit: NSF and returned payments.

Integration

How do you send and receive EFT payments with the TIB Finance API?

The TIB Finance API follows a simple model: your client account holds services, a service holds merchants (the entities whose bank accounts send or receive money), and each merchant has customers with payment methods. An EFT is an operation between a merchant and a customer's bank account.

  • Official SDKs for .NET, Node.js, Python, Java and PHP on GitHub. Every call is encrypted, and the SDK handles the key exchange for you.
  • Always read HasError. The API answers HTTP 200 even when a request fails. Details are in Errors (ErrorCode, ErrorMessage).
  • Send an IdempotencyKey on every money-moving call. For at least 24 hours, the same key with the same parameters returns the original response instead of creating a duplicate.

The C# examples below come from the official documentation at doc.tib.finance, which also shows each call in Java, Python, PHP and Node.js.

1. How do you authenticate?

Open a session with your client ID, username and password. The returned SessionId is the SessionToken you pass to every call.

TibInvoker.InitializePortal("https://sandboxportal.tib.finance");

CreateSessionResponse session = TibInvoker.Portal.CreateSession(new CreateSessionArgs
{
    ClientId = new Guid("YOUR-CLIENT-ID"),
    Username = "your-username",
    Password = "your-password"
});
if (session.HasError) { /* read session.Errors */ return; }
Guid sessionToken = session.SessionId;

2. How do you add a customer and a bank account?

Create the customer once (CreateCustomerV2 is recommended for new integrations), then attach the bank account. BankNumber is the 3-digit institution number and InstitutionNumber the 5-digit branch transit. For a PAD, keep the payer's signed agreement.

var account = TibInvoker.Portal.CreateDirectAccountPaymentMethod(new CreateDirectAccountPaymentMethodArgs
{
    SessionToken = sessionToken,
    CustomerId = customerId,
    IsCustomerAutomaticPaymentMethod = true,
    Account = new AccountModel
    {
        AccountName = "Operating account",
        Owner = "John Doe",
        BankNumber = "123",
        InstitutionNumber = "12345",
        AccountNumber = "1234567890",
        Currency = CurrencyEnum.CAD
    }
});
if (account.HasError) { /* read account.Errors */ return; }
Guid paymentMethodId = account.PaymentMethodId;

3. How do you send or collect an EFT?

One call does both. CreateFreeOperation with TransferType = FreeDeposit sends money to the bank account, and FreeCollection debits it. The amount ranges from 0.01 to 500,000 per operation, TransactionDueDate sets the date, TransferFrequency makes it recurring (weekly, every two weeks, monthly and more), and StatementDescription (15 characters max) appears on the bank statement.

string idempotencyKey = Guid.NewGuid().ToString(); // store it with your payment record

var op = TibInvoker.Portal.CreateFreeOperation(new CreateFreeOperationArgs
{
    SessionToken = sessionToken,
    IdempotencyKey = idempotencyKey,
    MerchantId = merchantId,
    CustomerId = customerId,
    PaymentMethodId = paymentMethodId,
    TransferType = TransferTypeEnum.FreeDeposit, // FreeCollection to debit
    Amount = 1250.00,
    TransactionDueDate = "2026-11-27T00:00:00",
    TransferFrequency = TransferFrequencyEnum.Once,
    ReferenceNumber = "INV-2026-1127",
    StatementDescription = "ACME PAYOUT",
    Language = LanguageEnum.English
});
// No answer (network timeout)? Send the same call again with the SAME idempotencyKey.
if (op.HasError) { /* read op.Errors, fix the cause, then retry with a NEW idempotencyKey */ return; }
Guid paymentId = op.PaymentId;

4. Can you upload an existing CPA-005 file?

Yes. CreateTransactionFromRaw takes the full text of a file in three formats: a CPA Standard 005 file (1,464-character records), TIB's semicolon format or a Sage 50 EFT export. The whole file is accepted or rejected. Once accepted, the call returns a TransactionsGroupId you use with ListTransfers to confirm every line. Each file carries the originator number TIB registered for your merchant, and file numbers follow each other (0041, 0042, and 0001 after 9999). Never renumber and resend a file whose result you don't know. The portal and file upload handle batches of up to 5,000 operations.

5. How do you track EFT status with webhooks?

Every EFT goes through four steps: Validation, Transmission, StatusCheck and Payback. TIB sends a webhook (HTTPS POST, JSON body) at each step with a Status such as Success_Success or Error_Fatal and a DescriptionCode (1 Confirmed, 3 NoFund, 4 AccountError, 5 Opposition). Send your HTTPS URL to your TIB representative, accept only source IPs in 204.225.113.0/24, answer HTTP 200 quickly and process events idempotently.

const allowed = (ip) => /^(::ffff:)?204\.225\.113\.\d{1,3}$/.test(ip);

app.post("/tib/webhook", (req, res) => {
  if (!allowed(req.socket.remoteAddress ?? "")) {
    return res.sendStatus(403);
  }
  res.sendStatus(200);
  queue.push(req.body); // process async, idempotent on TransferId + Step + Status
});

For reconciliation, ListExecutedOperations returns the operations of a period (FromDate and ToDate in UTC). EFT is processed in batches, so schedule this call instead of polling, with DateType = LastModifiedDate to catch returns that arrive later. Full reference: webhook documentation.

6. How do you test in the sandbox and go live?

The free sandbox sends your API credentials by email instantly, with no commitment and no credit card. Point the SDK to https://sandboxportal.tib.finance and simulate the outcomes your code must handle: a successful EFT, a failed validation, an NSF return. To go live, open your account, validate your integration with the TIB team, which confirms the activation steps for your environment, then switch the base URL to https://portal.tib.finance.

At a glance

What does the TIB Finance EFT API include?

FeatureTIB Finance EFT API
DirectionsEFT credits (deposits, payouts) and EFT debits (PAD), one-time or recurring
ChannelsAPI, file upload and portal
File formatsCPA Standard 005 (1,464 characters), TIB semicolon format, Sage 50 EFT export
Amount per operation0.01 to 500,000
Deposit timing1 to 2 business days, or seconds with TIB's proprietary instant payment system
Status trackingWebhook at every step, plus ListExecutedOperations
Duplicate protectionIdempotencyKey, honoured for at least 24 hours
PricingPlans from $25/month, adapted to your volume and business model: talk to our team
Security and statusPCI DSS Level 1, SOC 1 and SOC 2 Type 2, PSP registered with the Bank of Canada since September 28, 2026
SandboxFree, API credentials by email instantly

TIB Finance (9372-2544 Québec inc.) is a Canadian sovereign payment processor headquartered in Montréal, registered as a payment service provider under the Retail Payment Activities Act. Read more: what PSP registration means.

Platforms and partners

Building a platform that moves money for your own clients?

TIB Finance is built for B2B and multi-tenant processing: businesses and software platforms build their own payment offer on TIB, for their own clients.

  • Onboard your own clients: add each client as a merchant under your account and process their EFTs under your offer, with white-label and multi-tenant architecture.
  • One integration, separate merchant accounts: every client keeps its own merchant account, managed from the same API integration.
  • A team at your side: we help you design your offer and connect your platform. Become a partner or see our business integration services.
How to do it with TIB Finance

How do you launch EFT payments with TIB Finance?

1

Open a free sandbox

API credentials by email, instantly, and an SDK for your language.

2

Build the EFT flow

Session, customer, bank account, then CreateFreeOperation or your CPA-005 file.

3

Plug in webhooks

Receive every step, handle returns and reconcile with ListExecutedOperations.

4

Go live

Open your account, validate with our team and switch to the production URL.

Frequently Asked Questions

EFT API questions developers ask

What is an EFT API?

An EFT API lets software send and collect Canadian electronic funds transfers through API calls instead of bank files. With TIB Finance, one API sends EFT credits, collects pre-authorized debits, imports CPA-005 files and reports every status by webhook.

Is EFT in Canada the same as ACH?

EFT plays the role ACH plays in the United States, but it runs on Canadian rules: AFT files in Payments Canada Standard 005, cleared and settled through the ACSS. See EFT vs ACH.

How long does an EFT payment take with TIB Finance?

EFT deposits arrive in 1 to 2 business days. For payments that cannot wait, TIB's proprietary instant payment system moves the money in seconds.

Can I send EFT payments and collect pre-authorized debits with the same API?

Yes. CreateFreeOperation sends money with the FreeDeposit transfer type and collects it with FreeCollection, once or on a recurring schedule.

Can I keep sending my CPA-005 files?

Yes. CreateTransactionFromRaw accepts CPA Standard 005 files (1,464-character records), TIB's semicolon format and Sage 50 EFT exports, so you can move to the API at your own pace.

How do I know if an EFT was returned?

TIB sends a webhook at each processing step, including Payback, with a status and a DescriptionCode such as 3 (NoFund) or 4 (AccountError). ListExecutedOperations returns the same results for reconciliation.

How much does the TIB Finance EFT API cost?

Plans from $25/month, with a price adapted to your volume and business model. Talk to our team for a quote that fits your business.

Is TIB Finance registered with the Bank of Canada?

Yes. TIB Finance (9372-2544 Québec inc.) has been registered as a payment service provider with the Bank of Canada under the Retail Payment Activities Act since September 28, 2026. It is also PCI DSS Level 1 certified.

Get started

Start building your EFT integration today

One Canadian API for EFT credits, pre-authorized debits, Interac e-Transfer, cards and instant payments, with bilingual support from Montréal. A real, human team supports every client and partner, and integration is free for eligible businesses: TIB Finance sends people.

EFT • PAD • Interac • Instant payments • Cards • Bilingual support