Non, pas en pixels, en euros.

Non, pas par carte de crédit.

Oui avec téléphone.

Motivation

Si vous vendez des produits ou des services, être payé est une exigence évidente.

De nos jours, la carte de crédit est reine, en tout cas en ligne.

Vous disposez d'une multitude de passerelles de paiement, qui géreront les cartes de crédit, Google ou Apple Pay pour vous.

Contre paiement, bien sûr.

Dans un magasin physique, vous disposerez d'un terminal de carte de crédit.

Certaines banques peuvent vous vendre une application Android beaucoup moins chère qui transforme votre téléphone en terminal CC.

Cela vaut la peine d’y réfléchir, surtout si vous ne traitez que quelques paiements par jour.

Ces options couvrent presque toutes les situations dans des scénarios de consommation typiques.

Où une personne va en ligne ou dans un magasin physique et achète un tas de produits ou se fait couper les cheveux.

Mais il y a bien plus encore.

1. Que se passe-t-il si vous êtes une organisation à but non lucratif ou citoyenne qui doit traiter de petits paiements.
2. Que faire si vous êtes une entreprise B2B et que vos clients souhaitent payer par virement direct.
3. Ou que se passe-t-il si vous ne voulez tout simplement pas payer les frais généraux d'environ 2 à 3 % pour les paiements par carte de crédit.

Dans tous ces cas, la réponse, dans l'Union européenne, est le SEPA.

Plus spécifiquement le virement SEPA.

Ou son frère plus jeune, mais beaucoup plus rapide, le virement de crédit instantané SEPA.

Virement SEPA

Si vous n'êtes pas familier avec le nom, ne vous inquiétez pas, il s'agit du même vieux virement bancaire.

Par exemple. vous dites à votre banque de retirer de l'argent de votre compte et de le remettre à quelqu'un d'autre.

Ce qui était historiquement un formulaire papier à remplir, c'est aujourd'hui quelques clics dans votre application bancaire mobile.

Mais nous disposons désormais de numéros de comptes bancaires internationaux standardisés : les IBAN.

Il est donc très facile d'envoyer de l'argent partout dans l'UE ou même dans le monde entier.

Et avec SEPA instant, votre argent arrive en quelques secondes.

Mais, mais les IBAN sont si longs qu'ils sont presque effrayants.

Et les gens sont notoirement mauvais pour saisir des choses, vous pouvez donc être heureux si vous obtenez le bon montant, oubliez les notes supplémentaires.

Tous ces problèmes sont facilement résolus grâce aux codes QR.

Vos clients peuvent les scanner avec leur téléphone, vérifier le montant et cliquer sur Payer dans leur application bancaire.

Avec la liste croissante des banques participant au système de virement instantané SEPA, il y a de fortes chances que votre argent arrive en un clin d'œil.

Dans un prochain blog, nous verrons comment surveiller les paiements entrants sur votre compte bancaire.

Pour automatiser la génération et l'envoi de factures par exemple.

Laissez-moi vous montrer comment générer des codes QR pour la Slovaquie et la République tchèque.

Je souhaite allonger cette liste, donc si vous savez comment les codes QR sont créés dans votre pays, faites-le moi savoir.

QR Slovaquie

Les banques slovaques se sont mises d'accord sur une norme commune appelée Pay by Square.

Il existe même un schéma d'URL qui peut être utilisé dans des scénarios en ligne.

Par exemple. l'utilisateur clique sur un lien et son application bancaire est lancée avec toutes les informations de paiement renseignées.

Malheureusement, ceux-ci ne sont pas interopérables (en 2024).

Laissez-moi vous montrer comment générer le code QR dans NodeJS.

app.get("/api/paybysquare", mustAuth, async (req, res, next) => {
    try {
        const body = req.query.content as string;
        const model = JSON.parse(body);
        const content = await generate(model);
        const qrStream = new PassThrough();
        const result = await toFileStream(qrStream, content,
            {
                type: 'png',
                width: 200,
                errorCorrectionLevel: 'H'
            }
        );

        qrStream.pipe(res);
    } catch (ex) {
        next(ex);
    }
});

La méthode de génération provient de la bibliothèque bysquare.

Vous pouvez l'installer avec npm comme d'habitude npm i bysquare

Pour obtenir une image PNG que nous pouvons utiliser dans le navigateur ou dans un document de facturation, nous appelons la méthode comme ceci.

interface IBySquareModel {
    IBAN: string;
    Amount: number;
    CurrencyCode: string; // must be "EUR",
    VariableSymbol: string;
    Payments: number; // must be 1,
    PaymentOptions: number; // must be 1,
    BankAccounts: number; // must be 1,
    PaymentNote?: string; // optional note
}

const BySquareQR = (payModel: IBySquareModel) => {
    return 
}

Il est souvent très utile d'ajouter un message descriptif au paiement.

Voici un code simple qui normalisera les noms des clients.

Cela supprimera les signes diacritiques, transformant Ján Kováč en Jan Kovac.

Doit être toujours parfaitement lisible et garantira que les systèmes bancaires ne gâchent pas les choses.

    const paymentMessage = customerName?.normalize("NFKD").replace(/[\u0300-\u036f]/g, "").substring(0, 100) || "";

QR République tchèque

Même si la République tchèque ou la Tchéquie ont jusqu'à présent (2024) résisté à l'euro, elles ont elles aussi un système de code QR.

Et ils ont même un générateur de code libre de droits que nous pouvons utiliser.
Désormais, pour des raisons de sécurité, vous souhaiterez peut-être toujours le générer vous-même.

const czQrLink = "https://api.paylibo.com/paylibo/generator/image?iban="   iban   "&amount="   
czkPrice   "&currency=CZK&vs="   vsym   
"&message="   message;

const CzQrImage = (czQrLink: string) => {
    return 
}

International

Malheureusement, il n'existe pas encore de norme QR internationale ou européenne.

Vous devrez donc afficher le bon code QR en fonction du pays de votre utilisateur.

Si vous attendez des paiements depuis la République tchèque, gardez à l'esprit que les codes QR tchèques ne fonctionnent qu'en couronnes tchèques (monnaie tchèque CZK).

Ou si vous résidez en République tchèque et que vous attendez des paiements depuis la Slovaquie, le QR ne fonctionne qu'en euros.

Le code ci-dessous peut vous aider à calculer le montant en devise approprié.

Nous obtenons d’abord le taux de change de référence actuel de la banque centrale.

Ensuite, nous calculons les prix en euros et en tchèque, en fonction du prix du produit et de la devise.

const getExchangeRate = async () => {
    const now = new Date();
    const dt = new Date(now.getFullYear(), now.getMonth(), now.getDate() - 1).toISOString().substring(0, 10);

    const url = "https://nbs.sk/export/sk/exchange-rate/"   dt   "/xml";
    const dat  = { url: url }
    const opts = {
        headers: {
            'Content-Type': 'application/json'
        },
        method: "POST",
        body: JSON.stringify(dat)
    }

    const resp = await fetch("/api/httpfetch", opts);
    const xml = await resp.text();

    const parser = new DOMParser();
    const xmlDoc = parser.parseFromString(xml, "text/xml");
    const node = xmlDoc.querySelector("Cube [currency='CZK']");
    if (node) {
        const attr = node.getAttribute("rate");
        if (attr) {
            const num = attr.replace(/\s/, "").replace(",", ".");
            return  num;
        }
    }
    return undefined;
}

    // basePrice is the amount to be paid, for the products or services
    // currencyCode is the currency the products or services are sold in.
    const czkRate = await getExchangeRate();

    const eurPrice = currencyCode === "EUR" ? basePrice : (Math.ceil(basePrice / czkRate * 100) / 100).toFixed(2);
    const czkPrice = currencyCode === "CZK" ? basePrice : (Math.ceil(basePrice * czkRate * 100) / 100).toFixed(2);

Soyez payé

Essayer de lire des IBAN mal imprimés sur des factures ou même taper des IBAN horriblement longs est très ennuyeux.

Le fait qu’il faut être très prudent et vérifier trois fois, parce que c’est de l’argent, le rend encore plus vrai.

Nous créons des logiciels pour nous faciliter la vie, et les codes QR pour les paiements répondent parfaitement à cet objectif.

J'espère que vous avez trouvé ces informations utiles, et si vous avez des conseils sur vos systèmes nationaux de codes QR, n'hésitez pas à me les envoyer.

Bon piratage !