Référence API

Enregistrer une carte à l'inscription pour prélever plus tard, sans rien redemander au porteur.

Aucun montant n'est en jeu. Ni la requête, ni l'objet, ni la table ne portent de somme : il est structurellement impossible de débiter par ce chemin.

Enregistrer une carte pour ne pas la redemander.

Tupay ne reçoit jamais de numéro de carte. La carte est tokenisée dans le navigateur du porteur, chez le prestataire, sur son domaine à lui ; vous ne nous transmettez que le jeton obtenu. C'est ce qui maintient votre intégration — et la nôtre — dans le périmètre PCI-DSS SAQ A, le plus léger.

Déclarer une fois ce que vous vendez, puis encaisser en pointant l'article plutôt qu'en recopiant libellé et montant.

Un article se désactive, il ne se supprime pas : l'état est réversible, et ses tarifs existants continuent de fonctionner.

La preuve de paiement envoyée au client final, pas à vous.

Elle part toute seule dès qu'un paiement aboutit avec une adresse connue — celle de la fiche client rattachée, ou celle saisie dans le tunnel. Vous n'avez rien à déclencher.

Ces routes sont le journal : à quelle adresse, quand, et ce qui a échoué. Un envoi qui rate ne remet jamais un encaissement en cause.

Une page de paiement hébergée par Tupay, à laquelle vous envoyez votre client. Vous n'affichez ni formulaire, ni montant : la session porte les deux.

Le total est figé à la création. Modifier ou désactiver un tarif ensuite ne change pas ce que la session affiche — le prix montré au client est celui qu'il paiera.

Une session ne se règle qu'une fois. Un second paiement est refusé en 409, y compris pendant que le premier est encore en cours chez la banque. La garantie est tenue par la base, pas par la route.

Lier un client à un tarif récurrent, pour encaisser sans y penser.

Un abonnement condamné est refusé à la création. Un client sans moyen de paiement, ou un tarif ponctuel, valent une erreur qui nomme la cause — plutôt qu'un abonnement qui échouera à sa première échéance, du côté du client.

Émises automatiquement à l'échéance d'un abonnement, et prélevées dans la foulée sur la carte enregistrée.

Les montants sont TTC. La TGC y est comprise et non ajoutée : htXpf + tgcXpf vaut exactement amountXpf, toujours, et la base le vérifie.

Une facture émise ne se réécrit pas. Elle conserve le taux et les montants qu'elle portait, même si vous changez de régime demain.

Un prélèvement refusé est relancé selon un barème en jours — 1 j → 3 j → 5 j → 7 j, cinq tentatives sur seize jours. Chacune est journalisée. Au bout, la facture passe en souffrance et l'abonnement avec ; nous ne résilions jamais à votre place.

Le carnet d'adresses du marchand : reconnaître une personne d'un paiement à l'autre plutôt que de traiter chaque encaissement comme un inconnu de passage.

Ce que Tupay a émis, indépendamment de ce qui a été livré.

Obtenir une clé de test sans inscription ni validation humaine.

Encaissement au comptoir depuis l'application mobile Tupay.

Ces routes n'acceptent pas les clés API. Elles sont authentifiées par la session du marchand ; cf. le schéma de sécurité SessionCookie.