Intégrations
Connectez-vous à votre façon : API, pages hébergées ou sans code
Choisissez la voie qui correspond à votre équipe et à votre périmètre PCI : développez sur l’API REST, intégrez un checkout hébergé, envoyez un Payment Link ou chargez un lot dans le Business Portal, et laissez votre outil de code IA lire le contrat réel.
- API REST
- Sandbox Stage
- Webhooks signés
- Serveur MCP public
API RESTSept voies
Choisissez votre mode de connexion
Les mêmes comptes, soldes et rapports se trouvent derrière chaque voie : vous pouvez démarrer léger et compléter ensuite.
API REST directeLe plus flexible
Contrôle total sur les encaissements, décaissements, comptes virtuels, le change et le reporting. JSON sur HTTPS, appelé depuis votre serveur, avec des webhooks signés à chaque changement de statut.
API REST directe —WebCheckout hébergéSans code
Redirigez vos clients vers un checkout hébergé par Localpayment avec les méthodes locales que vous activez. Aucun code front-end à maintenir.
WebCheckout hébergé —Payment LinksSans code
Créez un lien dans le Business Portal et partagez-le par e-mail, SMS ou réseaux sociaux. Idéal pour les factures, la vente à distance et les paiements ponctuels.
Payment Links —iframe intégréeMarque blanche
Placez un checkout en marque blanche dans votre propre page et gardez votre marque autour, avec un périmètre PCI réduit.
iframe intégrée —SDK JS Smart FieldsFormulaire sur mesure
Des champs carte hébergés, tokenisés dans le navigateur puis consolidés en un jeton à usage unique que votre serveur débite ensuite. Vous gardez la main sur le design du formulaire.
SDK JS Smart Fields —Lots Business PortalOpérations
Chargez des fichiers de décaissements et de comptes virtuels et suivez les résultats dans le portail. Aucun travail d’intégration pour la finance et les opérations.
Lots Business Portal —Serveur MCP pour l’IAAssisté par IA
Un serveur MCP public en lecture seule et le fichier llms.txt permettent à Cursor, VS Code, Claude et d’autres assistants de développer sur l’API documentée.
Serveur MCP pour l’IA —
Comparer
Effort, périmètre PCI et meilleur usage
Un guide pour présélectionner. Votre périmètre PCI final dépend de la manière dont vous collectez et stockez les données de carte ; confirmez-le avec votre évaluateur.
API REST directe
- Effort
- Élevé : développement côté serveur
- Périmètre PCI
- Dépend de la collecte des données de carte ; à associer à Smart Fields ou à une option hébergée
- Idéal pour
- Plateformes qui veulent un contrôle total des encaissements, décaissements et du change
WebCheckout hébergé
- Effort
- Faible : redirection
- Périmètre PCI
- Minimal
- Idéal pour
- Équipes qui veulent activer vite les méthodes locales
Payment Links
- Effort
- Très faible : sans code
- Périmètre PCI
- Minimal
- Idéal pour
- Factures, vente à distance, paiements ponctuels
iframe intégrée
- Effort
- Faible à moyen
- Périmètre PCI
- Réduit
- Idéal pour
- Checkout à votre image sans manipuler les champs carte
SDK JS Smart Fields
- Effort
- Moyen : front-end et serveur
- Périmètre PCI
- Partagé
- Idéal pour
- Design de checkout sur mesure avec champs carte hébergés
Lots Business Portal
- Effort
- Très faible : dépôt de fichier
- Périmètre PCI
- Aucune donnée de carte
- Idéal pour
- Finance et opérations qui exécutent décaissements et comptes virtuels
Serveur MCP pour l’IA
- Effort
- Faible : ajouter une URL
- Périmètre PCI
- Sans objet : aucune donnée de paiement
- Idéal pour
- Ingénieurs qui utilisent des assistants de code IA
Les identifiants Stage (sandbox) sont remis au début du partenariat. L’accès à la production suit les tests, une revue de sécurité et la vérification de l’entreprise.
L’API en pratique
Un encaissement API typique, de bout en bout
Quatre acteurs, six étapes. Votre backend ne parle qu’à une seule API ; le rail local est géré pour vous.
- 1
Backend du marchandAPI Localpayment:
S’authentifier
POST /api/token/ renvoie un jeton d’accès à courte durée. Les appels partent de votre serveur, depuis une IP autorisée.
- 2
Backend du marchandAPI Localpayment:
Créer l’encaissement
POST /api/payin/ avec votre propre externalId, le pays, la devise, le montant et la méthode de paiement.
- 3
API LocalpaymentRail local:
Router vers le rail local
Localpayment envoie la demande sur le rail que vous avez activé, comme Pix, SPEI ou PSE.
- 4
Rail localAPI Localpayment:
Le client paie
Le rail confirme le paiement. Les rails temps réel confirment en quelques secondes, 24h/24 et 7j/7.
- 5
API LocalpaymentEndpoint webhook:
Webhook signé
Un webhook avec l’en-tête X-Signature HMAC-SHA256 annonce le nouveau statut.
- 6
Endpoint webhookBackend du marchand:
Vérifier et mettre à jour
Vérifiez la signature, dédoublonnez sur externalId ou internalId, répondez 200 et mettez la commande à jour.
Illustration simplifiée avec des données fictives. Consultez le quickstart pour les champs exacts de requête et de réponse.
Passer en production
De l’accord signé à la production
Obtenez les identifiants Stage
Les identifiants sandbox arrivent au début du partenariat : l’ingénierie démarre pendant la revue de conformité.
Développez et testez dans Stage
Stage reproduit la production sans argent réel. Utilisez les cartes de test, le simulateur de comptes virtuels et la collection Postman.
Revue et vérification
Les identifiants de production suivent les tests terminés, une revue de sécurité et la vérification de l’entreprise.
Passez en production en quelques semaines
Changez l’URL de base et les identifiants, autorisez vos IP et démarrez. Les nouveaux marchés s’activent par configuration, sans réintégration.
FAQ
Questions sur l’intégration
Par quelle voie commencer ?
Si vous avez besoin de contrôle et d’ingénieurs, commencez par l’API REST. Si vous voulez activer vite les méthodes locales, utilisez WebCheckout ou Payment Links. Les voies peuvent se combiner sur un même compte.
Proposez-vous des SDK serveur ?
Il n’existe pas de SDK serveur officiel. L’API REST est du JSON sur HTTPS et la documentation montre des exemples cURL et Node.js. Le seul SDK est le SDK JS Smart Fields, côté client.
Comment les appels API sont-ils sécurisés ?
Les appels se font en HTTPS depuis des environnements serveur, avec des jetons Bearer, et exigent l’autorisation des IP. Les webhooks sont signés en HMAC-SHA256 pour vérifier qu’ils viennent de Localpayment.
Comment éviter les débits en double ?
Envoyez votre propre externalId unique pour chaque transaction. Un doublon renvoie HTTP 409, et les consommateurs de webhooks doivent dédoublonner sur externalId ou internalId.
Quel impact sur notre périmètre PCI ?
Cela dépend de la voie. WebCheckout hébergé et Payment Links gardent un périmètre minimal, l’iframe intégrée le réduit et Smart Fields le partage. Confirmez le résultat avec votre évaluateur.
Comment les outils de code IA aident-ils ?
Ajoutez le serveur MCP public en lecture seule (docs.localpayment.com/mcp) à Cursor, VS Code, Claude ou des outils similaires. Ils lisent alors l’API documentée au lieu de deviner.
Combien de temps dure l’intégration ?
Les identifiants Stage arrivent au début du partenariat et la mise en production prend quelques semaines, selon la voie et vos cycles de revue. Parlez aux ventes pour un plan adapté.
Commencez à construire dès aujourd’hui
Dites-nous vos marchés et votre stack. Nous vous recommanderons la voie d’intégration et préparerons vos identifiants Stage.