UNIPaaS/agent-skills

Unipaas

Fondation

Unipaas fournit des paiements intégrés de bout en bout pour les plateformes numériques et les marketplaces (SaaS, économie de plateforme, marketplaces B2B/B2C). Vous intégrez des vendeurs (sous-marchands), acceptez des paiements, gérez des comptes (soldes) et effectuez des versements — tout en contrôlant les flux financiers et en restant conforme PSD2/PCI.

Obtenez une clé sandbox. Créez un compte de test gratuit sur https://portal.unipaas.com/signup. Le compte de test est illimité et toujours disponible. Trouvez votre clé privée dans le portail sous la section développeur/clés. Les identifiants Sandbox et Live sont complètement séparés et ne partagent aucune donnée.

URL de base.

• Sandbox : https://sandbox.unipaas.com/platform
• Production (Live) : https://api.unipaas.com/platform

Deux modes d'authentification (détails dans references/auth.md).

1. Serveur-à-serveur : envoyez votre clé privée comme Authorization: Bearer {{PRIVATE_KEY}} directement dans les appels API (création de checkout, encaissements, comptes, versements, onboarding). La clé privée doit rester côté serveur.
2. Flux /authorize en deux étapes (pour les embeds de plateforme côté client) : votre serveur POST la clé privée sur /authorize avec des scopes et (généralement) un vendorId, et reçoit un accessToken temporaire. Le client utilise ce token d'accès — jamais la clé privée.

Idempotence. Pour éviter des exécutions en double lors de nouvelles tentatives, ajoutez un en-tête requestId: <id> aux requêtes POST. Une même requestId appliquée plusieurs fois donne un seul résultat. Les identifiants de requête sont valides pendant 24 heures.

Arbre de décision

Quatre produits, trois niveaux d'intégration. Choisissez le niveau qui correspond à votre capacité de développement et à votre posture PCI.

Produit	Sans code	Faible effort	Effort moyen
Onboarding	Lien d'onboarding hébergé	Interface intégrée (unipaas.components)	API d'onboarding
Accepter les paiements	Lien de paiement (portail)	Page de checkout / SDK Web	API d'encaissement (serveur-à-serveur)
Gestion des comptes	Vue portail	Composant Compte/Solde	API de compte
Effectuer les versements	Versement manuel/planifié via le portail	Formulaire de versement / Composant Compte	API de versements

Recommandations :

• Vous voulez zéro code ? Utilisez le Lien de paiement, le lien d'onboarding hébergé, les versements via le portail.
• Vous voulez votre propre interface avec peu d'effort + PCI réduit ? Utilisez la Page de checkout (redirection), les champs sécurisés du SDK Web, ou les web-embeds acheteur ; utilisez les embeds de plateforme pour l'onboarding, le solde et le portail.
• Vous voulez un contrôle total / une solution white-label / une application native ? Utilisez les API. L'API d'encaissement (données brutes de carte) nécessite PCI SAQ D.

Remarque : une transaction envoyée sans vendorId est enregistrée sur le compte de la plateforme.

Chemins de checkout côté client

Voir references/web-sdk.md pour les étapes complètes. Deux chemins de paiement acheteur, tous deux authentifiés avec le sessionToken retourné par un POST /pay-ins/checkout côté serveur — pas le token d'accès /authorize.

1. SDK Secure-fields — chargez https://cdn.unipaas.com/unipaas.sdk.js (expose le global Unipaas). Construisez votre propre formulaire de carte, puis new Unipaas().initTokenize(sessionToken, fields, options). Les champs sécurisés sont une fonctionnalité de ce bundle, pas un package séparé.
2. Web-embeds acheteur — chargez https://cdn.unipaas.com/embedded-ui.js, puis unipaas.buyerComponents(sessionToken, config) et .create("checkout"|"card"|"digitalWallet").mount("#id").

Limite d'authentification (important) :

• Paiement acheteur (secure fields et web-embeds acheteur) → sessionToken de POST /pay-ins/checkout.
• Embeds de plateforme (unipaas.components : solde, facture, onboarding, payPortal, notification) → le token d'accès /authorize avec scopes + vendorId. Le checkout acheteur n'utilise pas le token d'accès /authorize.

Après toute autorisation côté client, vérifiez côté serveur avec GET /pay-ins/{authorizationId} ; le statut doit être CAPTURED pour un succès.

Références

• references/auth.md — le flux /authorize, les scopes, le cycle de vie du token, l'idempotence.
• references/accept-payments.md — le produit Accepter les Paiements, les trois niveaux, la Page de Checkout, créer un paiement, la tokenisation, les webhooks.
• references/web-sdk.md — les deux chemins de paiement acheteur côté client alimentés par le sessionToken.
• references/security.md — la gestion des clés, ce qui reste côté serveur, la surface PCI.