Guide développeur : les TEF au Canada

API TEF Canada : envoyez et recevez des paiements TEF depuis votre code

Une API TEF permet à votre logiciel d'envoyer et de prélever des transferts électroniques de fonds au Canada, sans monter de fichiers bancaires à la main. TIB Finance, le processeur de paiement souverain canadien dont le siège social est à Montréal, vous donne une seule API TEF pour payer fournisseurs et employés, prélever vos clients par débit préautorisé (DPA) et suivre chaque transfert par webhook. Ci-dessous : les TEF au Canada, puis l'intégration avec TIB.

Mis à jour le 22 novembre 2026 • FSP inscrit auprès de la Banque du Canada • Plus de 1 000 entreprises • PCI DSS niveau 1

Définition

Qu'est-ce qu'un paiement TEF au Canada?

Un TEF (transfert électronique de fonds) fait passer l'argent directement d'un compte bancaire canadien à un autre. Les règles de Paiements Canada parlent de transfert automatisé de fonds (TAF) : un crédit ou un débit échangé entre institutions financières dans un fichier conforme à la Norme 005, puis compensé et réglé dans le Système automatisé de compensation et de règlement (SACR), selon la Règle F1. On le compare souvent à l'ACH américain (voici ce qui les distingue).

  • Crédit TEF (dépôt direct). Vous versez de l'argent dans un compte : paie, paiements aux fournisseurs, remboursements, commissions, versements.
  • Débit TEF (débit préautorisé, DPA). Vous prélevez l'argent dans le compte d'un payeur qui vous a signé une autorisation, selon la Règle H1 de Paiements Canada. Voyez l'API DPA et les règles des DPA au Canada.

Une API TEF réunit les deux sens en quelques appels. Votre application dit qui payer ou prélever, combien et quand. Le processeur monte les fichiers bancaires, les transmet, suit chaque transaction et vous en rapporte le résultat.

Fonctionnement

Comment fonctionne un fichier TEF CPA-005?

Les institutions financières s'échangent les TEF dans des fichiers à longueur fixe définis par la Norme 005 de Paiements Canada, qu'on appelle souvent le format CPA-005. Chaque enregistrement logique compte 1 464 caractères, et son premier caractère en donne le type.

EnregistrementContenu
A (en-tête)En début de fichier : numéro d'émetteur, numéro et date de création, centre de données destinataire, devise.
C (crédit)Crédits : l'argent versé aux bénéficiaires.
D (débit)Débits : les DPA prélevés chez les payeurs.
E / FAnnulation par l'émetteur d'une transaction C ou D.
I / JRetours envoyés par l'institution qui refuse la transaction.
Z (fin)Dernier enregistrement : nombre et valeur totale des débits et des crédits.

Chaque enregistrement C ou D regroupe jusqu'à six segments de transaction. Un segment contient le code du type d'opération, le montant, la date à laquelle les fonds doivent être disponibles, les numéros d'institution et de transit, le numéro de compte, le nom abrégé (15 caractères) et le nom complet (30) de l'émetteur, le nom du bénéficiaire ou du payeur (30), un numéro de référence et le compte des retours.

Monter, numéroter et équilibrer ces fichiers : c'est exactement le travail qu'une API TEF vous enlève. Et si votre système produit déjà des fichiers CPA-005, TIB Finance les accepte tels quels.

Délais

Combien de temps prend un TEF au Canada?

Selon la Règle F1, les institutions s'échangent les fichiers TEF les jours ouvrables, en trois périodes qui se terminent à 9 h 30, 16 h 30 et 21 h, heure de l'Est.

  • Crédits. Quand la succursale qui reçoit a le code de service « 0 », les fonds doivent être disponibles dans les 2 heures suivant l'heure limite d'échange. Un crédit reçu le jour ouvrable précédant son échéance doit être disponible à l'ouverture des bureaux ce jour-là.
  • Débits. Un débit ne peut pas être livré avant sa date d'échéance : un DPA se planifie pour une date précise.
  • Retours. Une institution doit retourner une transaction au plus tard le jour ouvrable suivant sa réception par la première unité apte à décider.

Avec TIB Finance, les dépôts TEF arrivent en 1 à 2 jours ouvrables. Quand un paiement ne peut pas attendre, le système de paiement instantané propriétaire de TIB transfère l'argent en quelques secondes (paiements instantanés). Pour les jours fériés, voyez les heures limites des TEF.

Retours

Que veulent dire les codes de retour TEF?

Quand un TEF échoue, l'institution le retourne avec un code de motif à trois chiffres défini dans la Norme 007 de Paiements Canada. Les plus fréquents :

CodeSignificationCe que votre code doit faire
901Sans provisions, NSF (débits seulement)Présenter de nouveau une seule fois, dans les 30 jours civils suivant le retour. Un DPA doit garder le même montant.
902Compte introuvableFaire confirmer les numéros d'institution, de transit et de compte.
905Compte ferméObtenir de nouvelles coordonnées bancaires.
908Fonds non libérés (débits seulement)Même règle que le 901 : une seule nouvelle présentation dans les 30 jours civils.
912Numéro de compte invalide ou erronéCorriger le numéro de compte.
915 à 921Retours d'un débit enclenchés par le payeur : accord inexistant, non conforme à l'accord, accord révoqué, pas de confirmation ni de préavisRevoir l'accord de DPA et les préavis envoyés.

Règle H1 : un payeur peut réclamer le remboursement d'un DPA dans les 90 jours civils (DPA personnel) ou les 10 jours ouvrables (DPA d'entreprise). Liste complète : codes de retour TEF. Après un débit refusé : NSF et paiements retournés.

Développeurs

Comment envoyer et recevoir des TEF avec l'API de TIB Finance?

Le modèle de l'API de TIB Finance : votre compte regroupe des services, chaque service des marchands (les entités dont les comptes envoient ou reçoivent l'argent), chaque marchand ses clients et leurs modes de paiement. Un TEF relie un marchand au compte bancaire d'un client.

  • SDK officiels pour .NET, Node.js, Python, Java et PHP sur GitHub. Les appels sont chiffrés et le SDK gère l'échange de clés.
  • Lisez toujours HasError. L'API répond HTTP 200 même en cas d'échec; le détail est dans Errors (ErrorCode, ErrorMessage).
  • Ajoutez une IdempotencyKey à chaque appel qui déplace de l'argent. Pendant au moins 24 heures, la même clé avec les mêmes paramètres renvoie la réponse originale, sans doublon.

Exemples C# tirés de la documentation officielle, doc.tib.finance (aussi en Java, Python, PHP et Node.js).

1. Comment s'authentifier?

Ouvrez une session avec votre identifiant client, votre nom d'utilisateur et votre mot de passe. Le SessionId renvoyé devient le SessionToken de tous vos appels.

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

CreateSessionResponse session = TibInvoker.Portal.CreateSession(new CreateSessionArgs
{
    ClientId = new Guid("VOTRE-CLIENT-ID"),
    Username = "votre-utilisateur",
    Password = "votre-mot-de-passe"
});
if (session.HasError) { /* lire session.Errors */ return; }
Guid sessionToken = session.SessionId;

2. Comment ajouter un client et son compte bancaire?

Créez le client une seule fois (CreateCustomerV2 pour une nouvelle intégration), puis rattachez-lui son compte bancaire. BankNumber est le numéro d'institution à 3 chiffres et InstitutionNumber, le numéro de transit à 5 chiffres. Pour un DPA, conservez l'accord de DPA signé par le payeur.

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

3. Comment envoyer ou prélever un TEF?

Un seul appel fait les deux. CreateFreeOperation avec TransferType = FreeDeposit verse l'argent et FreeCollection le prélève. Le montant va de 0,01 à 500 000 par opération, TransactionDueDate fixe la date, TransferFrequency rend le paiement récurrent (chaque semaine, aux deux semaines, chaque mois, et plus) et StatementDescription (15 caractères au maximum) s'affiche sur le relevé.

string idempotencyKey = Guid.NewGuid().ToString(); // à conserver avec votre paiement

var op = TibInvoker.Portal.CreateFreeOperation(new CreateFreeOperationArgs
{
    SessionToken = sessionToken,
    IdempotencyKey = idempotencyKey,
    MerchantId = merchantId,
    CustomerId = customerId,
    PaymentMethodId = paymentMethodId,
    TransferType = TransferTypeEnum.FreeDeposit, // FreeCollection pour prélever
    Amount = 1250.00,
    TransactionDueDate = "2026-11-27T00:00:00",
    TransferFrequency = TransferFrequencyEnum.Once,
    ReferenceNumber = "FACT-2026-1127",
    StatementDescription = "ACME VERSEMENT",
    Language = LanguageEnum.French
});
// Aucune réponse (délai réseau dépassé)? Renvoyez le même appel avec la MÊME idempotencyKey.
if (op.HasError) { /* lire op.Errors, corriger la cause, puis réessayer avec une NOUVELLE idempotencyKey */ return; }
Guid paymentId = op.PaymentId;

4. Peut-on téléverser un fichier CPA-005 existant?

Oui. CreateTransactionFromRaw prend le texte complet d'un fichier en trois formats : le format CPA-005 de la Norme 005 (enregistrements de 1 464 caractères), le format à point-virgule de TIB ou l'export TEF de Sage 50. Le fichier est accepté ou refusé en entier; s'il est accepté, l'appel renvoie un TransactionsGroupId qui permet de confirmer chaque ligne avec ListTransfers. Chaque fichier porte le numéro d'émetteur que TIB a enregistré pour votre marchand, et les numéros de fichier se suivent (0041, 0042, puis 0001 après 9999) : ne renumérotez jamais, pour le renvoyer, un fichier dont vous ignorez le résultat. Le portail et le téléversement traitent des lots jusqu'à 5 000 opérations.

5. Comment suivre le statut d'un TEF avec les webhooks?

Chaque TEF passe par quatre étapes : Validation, Transmission, StatusCheck et Payback. TIB envoie un webhook (POST HTTPS, corps JSON) à chaque étape, avec un Status comme Success_Success ou Error_Fatal et un DescriptionCode (1 Confirmed, 3 NoFund, 4 AccountError, 5 Opposition). Envoyez votre URL HTTPS à votre représentant TIB, n'acceptez que la plage d'adresses IP 204.225.113.0/24, répondez HTTP 200 rapidement et traitez chaque événement de façon idempotente.

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); // traitement asynchrone, idempotent sur TransferId + Step + Status
});

Pour le rapprochement, ListExecutedOperations renvoie les opérations d'une période (FromDate et ToDate en UTC). Les TEF sont traités par lots : planifiez cet appel plutôt que d'interroger l'API sans arrêt, avec DateType = LastModifiedDate pour attraper les retours qui arrivent plus tard. Référence complète : documentation des webhooks.

6. Comment tester dans le sandbox et passer en production?

Le sandbox gratuit vous envoie vos identifiants API par courriel instantanément, sans engagement et sans carte de crédit. Pointez le SDK vers https://sandboxportal.tib.finance et simulez les cas à gérer : un TEF réussi, une validation échouée, un retour NSF. Pour passer en production : ouvrez votre compte, faites valider votre intégration par l'équipe TIB, qui vous confirme les étapes d'activation de votre environnement, puis passez à https://portal.tib.finance.

En un coup d'œil

Que comprend l'API TEF de TIB Finance?

FonctionAPI TEF de TIB Finance
SensCrédits TEF (dépôts, versements) et débits TEF (DPA), ponctuels ou récurrents
CanauxAPI, téléversement de fichiers et portail
Formats de fichierCPA-005, Norme 005 (1 464 caractères), format à point-virgule de TIB, export TEF de Sage 50
Montant par opération0,01 à 500 000
Délai des dépôts1 à 2 jours ouvrables, ou quelques secondes avec le système de paiement instantané propriétaire de TIB
Suivi des statutsWebhook à chaque étape, plus ListExecutedOperations
IdempotenceIdempotencyKey, respectée au moins 24 heures
TarificationForfaits à partir de 25 $/mois, adaptés à votre volume et à votre modèle d'affaires : parlez à notre équipe
Sécurité et statutPCI DSS niveau 1, SOC 1 et SOC 2 de type 2, FSP inscrit auprès de la Banque du Canada depuis le 28 septembre 2026
SandboxGratuit, identifiants API par courriel instantanément

TIB Finance (9372-2544 Québec inc.), processeur de paiement souverain canadien établi à Montréal, est inscrite comme fournisseur de services de paiement en vertu de la Loi sur les activités associées aux paiements de détail. Voyez ce que veut dire l'inscription comme FSP.

Plateformes et partenaires

Vous bâtissez une plateforme qui fait circuler l'argent de vos propres clients?

La plateforme TIB Finance est conçue pour le traitement B2B et multilocataire : les entreprises et les plateformes logicielles bâtissent leur propre offre de paiement sur TIB, pour leurs propres clients.

  • Intégrez vos propres clients : ajoutez chaque client comme marchand dans votre compte et traitez ses TEF sous votre offre, grâce à une architecture en marque blanche et multilocataire.
  • Une seule intégration, des comptes marchands distincts : chaque client a son propre compte marchand, géré à partir de la même intégration API.
  • Une équipe à vos côtés : nous vous aidons à concevoir votre offre et à brancher votre plateforme. Devenez partenaire ou découvrez nos services d'intégration.
Comment faire avec TIB Finance

Comment lancer vos paiements TEF avec TIB Finance?

1

Ouvrez un sandbox gratuit

Identifiants API par courriel, instantanément, et un SDK pour votre langage.

2

Montez le flux TEF

Session, client, compte bancaire, puis CreateFreeOperation ou votre fichier CPA-005.

3

Branchez les webhooks

Suivez chaque étape, gérez les retours et rapprochez avec ListExecutedOperations.

4

Passez en production

Ouvrez votre compte, validez avec notre équipe et passez à l'URL de production.

Questions fréquentes

Questions des développeurs sur l'API TEF

Qu'est-ce qu'une API TEF?

Une API TEF permet à un logiciel d'envoyer et de prélever des transferts électroniques de fonds au Canada par appels d'API, sans fichiers bancaires. Avec TIB Finance, une seule API envoie les crédits TEF, prélève les DPA, importe les fichiers CPA-005 et signale chaque statut par webhook.

Le TEF canadien, est-ce la même chose que l'ACH?

Le TEF joue au Canada le rôle de l'ACH américain, mais selon des règles canadiennes : des fichiers TAF conformes à la Norme 005 de Paiements Canada, compensés et réglés dans le SACR. Voyez TEF ou ACH.

Combien de temps prend un paiement TEF avec TIB Finance?

Les dépôts TEF arrivent en 1 à 2 jours ouvrables. Pour un paiement qui ne peut pas attendre, le système de paiement instantané propriétaire de TIB transfère l'argent en quelques secondes.

Peut-on envoyer des TEF et prélever des DPA avec la même API?

Oui. CreateFreeOperation verse l'argent avec le type FreeDeposit et le prélève avec FreeCollection, une fois ou de façon récurrente.

Peut-on continuer d'envoyer nos fichiers CPA-005?

Oui. CreateTransactionFromRaw accepte les fichiers CPA-005 de la Norme 005 (enregistrements de 1 464 caractères), le format à point-virgule de TIB et les exports TEF de Sage 50. Passez à l'API à votre rythme.

Comment savoir si un TEF a été retourné?

TIB envoie un webhook à chaque étape, y compris Payback, avec un statut et un DescriptionCode comme 3 (NoFund) ou 4 (AccountError). ListExecutedOperations donne les mêmes résultats pour le rapprochement.

Combien coûte l'API TEF de TIB Finance?

Forfaits à partir de 25 $/mois, avec un prix adapté à votre volume et à votre modèle d'affaires. Parlez à notre équipe pour une soumission sur mesure.

TIB Finance est-elle inscrite auprès de la Banque du Canada?

Oui. TIB Finance (9372-2544 Québec inc.) est inscrite comme fournisseur de services de paiement auprès de la Banque du Canada depuis le 28 septembre 2026, en vertu de la Loi sur les activités associées aux paiements de détail. Elle est aussi certifiée PCI DSS niveau 1.

Passez à l'action

Commencez votre intégration TEF dès aujourd'hui

Une seule API canadienne pour les TEF, les DPA, le Virement Interac, les cartes et les paiements instantanés, avec un service bilingue depuis Montréal. Une vraie équipe humaine accompagne chaque client et chaque partenaire, et l'intégration est gratuite pour les entreprises admissibles : TIB Finance vous envoie des gens.

TEF • DPA • Interac • Paiements instantanés • Cartes • Service bilingue