Infrastructure et metiers
account.mysoleas.com
Le domaine account correspond a Mysoleas Identity Cloud. C’est un service a part entiere, pas une simple dependance technique.
Utilisez-le pour:
- integrer le bouton Se connecter avec Mysoleas;
- authentifier un utilisateur avec OAuth2/OIDC;
- gerer la couche identite et utilisateur d’une application tierce;
- obtenir un JWT utilisateur pour ouvrir une session applicative;
- rafraichir ou revoquer un jeton;
- lire les claims utilisateur avec
/oauth/v2/userinfo; - permettre a une application tierce d’agir dans le contexte d’un utilisateur ou d’un client autorise.
api.mysoleas.com, creez une application dans SoleasPay et utilisez son client_id et son client_secret pour obtenir un token d’application.
Pour creer une application OAuth2, l’utilisateur doit avoir un compte Mysoleas, se connecter au dashboard https://mysoleas.com, puis parametrer son application, ses URLs de redirection et ses scopes.
api.mysoleas.com
Le domaine API est la gateway publique. Votre integration ne doit pas appeler les microservices internes directement.
Toutes les routes gateway attendent le token obtenu depuis l’application creee dans SoleasPay dans le header x-sp-auth-token.
- lister les pays;
- lister les services de paiement;
- verifier les providers actifs;
- creer et suivre des collections;
- creer et suivre des disbursements;
- creer des liens de paiement;
- gerer les souscriptions;
- piloter les autres domaines metier exposes progressivement par Mysoleas.
Regle d’authentification gateway
La gateway attend toujours le meme header:Domaines metier dans l’ecosysteme
SoleasPay
SoleasPay est le payment service processor de Mysoleas. Il agrege les moyens de paiement et expose les flux de collection, disbursement, souscription, lien de paiement, services, pays et providers.Mysoleas Identity Cloud
Identity Cloud gere les utilisateurs, les applications OAuth2, les tokens JWT utilisateur et les claims. Il sert de service d’identite autonome pour une application tierce. Les tokens gateway proviennent des applications SoleasPay creees pour les integrations API.MyShup
MyShup porte la gestion et l’automatisation des ventes. Il intervient dans les parcours commerciaux, les produits, les commandes mono-produit ou multi-produits, et les operations marchandes.Notification Service
Le Notification Service centralise les communications transactionnelles: confirmations, alertes, messages systeme et notifications liees aux evenements. Il porte aussi l’API marketing V2 pour les contacts, audiences, templates et campagnes, avec Listmonk comme moteur interne.MyBoost
MyBoost couvre le marketing a travers des campagnes boost, des challenges UGC, des promotions, l’activation client et la relance marketing.Flux de paiement standard
Les collections et disbursements utilisent un modele en trois etapes.
Ce modele evite les doubles debits. Il vous donne aussi un point clair pour reprendre une transaction apres un timeout reseau.
Flux plugin SoleasPay
Les plugins SoleasPay v4 ne suivent pas le meme modele que les appels gateway serveur a serveur.
Utilisez ces plugins pour une integration paiement rapide lorsque vous ne voulez pas gerer directement les credentials d’une application creee dans SoleasPay, les tokens gateway,
intent, execute et status.
Donnees de contexte
La gateway transporte le contexte de l’application creee dans SoleasPay et du tenant dans les claims du jeton. Elle peut aussi forwarder certains headers internes ou de trace.Etats importants
Une transaction peut passer par plusieurs etats non finaux avant d’aboutir.
Traitez
COMPLETED, FAILED, CANCELLED et REFUNDED comme des etats finaux.