Version de travail · contenus et exemples à affiner Voir les 95 pages ↗
Parlons de votre projet ↗
Commencer / P005

Bienvenue dans la documentation

Adaptation éditoriale
Référence de travail. Les routes, schémas, limites et procédures hérités du référentiel sont à aligner avec l’API d’Éric. Ils ne prouvent pas une fonctionnalité livrée. Les hôtes .invalid sont des exemples inertes.

Le paiement à distance, de bout en bout

Kelyko permet aux professionnels d’accepter un paiement depuis leur site ou un lien, de suivre les sommes qui leur reviennent et de demander un reversement vers une destination autorisée.

Deux portes d’entrée

Avec un site : module compatible, bouton, page hébergée ou intégration API selon votre environnement.

Sans site : créez un lien associé à une facture, une commande, une inscription ou une collecte. Votre client ouvre une page web et autorise son paiement dans le parcours du moyen choisi.

Les objets à connaître

Objet Rôle
Marchand Entreprise ou organisation, personnes habilitées et conditions
Magasin Unité de suivi : activité, site ou canal
Demande de paiement Tentative identifiée, montant, devise, référence et résultat
Lien Accès partageable à un parcours de paiement
Reversement Sortie contrôlée vers un bénéficiaire autorisé
Webhook Notification serveur dont l’authenticité doit être vérifiée

Une confirmation vérifiée

Le retour du navigateur sert à guider le client. Le résultat financier doit être confirmé côté serveur, rapproché de la demande puis appliqué une seule fois. Un timeout n’est pas une preuve d’échec.

Un registre qui explique les droits

Le brut, les frais et le net restent distincts. Le net encore dû appartient à un seul compartiment : en attente, disponible, réservé ou retenu. Les fonds réels relèvent du dispositif partenaire ; le registre ne crée pas un deuxième encaissement.

Avant d’intégrer

Les routes, champs et exemples issus du référentiel sont conservés pour préparer le travail d’intégration. Ils doivent être confrontés au contrat API d’Éric avant de devenir la documentation d’exécution. Les adresses en .invalid sont volontairement non opérationnelles.