Copy page

Getting Started

Bienvenue sur Verso

Verso développe une API de paie française pour les mandataires sociaux. Le premier périmètre est le président de SASU sans contrat de travail qui démarre sa paie, sans reprise d'une paie existante. Les salariés et autres profils ne sont pas annoncés comme pris en charge.

Commencez par le périmètre et les prérequis : cette page distingue la cible produit, les cas à qualifier et la disponibilité vérifiée sur votre environnement. La présence d'une route dans la référence API ne suffit pas à rendre un dossier éligible.

Le Quickstart décrit les mécanismes techniques de calcul. Ses exemples historiques ne constituent pas un parcours de première paie SASU validé ni une autorisation de production.

Understanding Partners and Tenants

If you're reading this documentation, you are a Partner — a SaaS company using Verso's API to deliver payroll services.

Concept	Definition	Example
Partner	Your company (the SaaS provider using Verso)	Your GTA or payroll SaaS platform
Tenant	Your end clients (companies you provide payroll services to)	SMBs, startups, enterprises

How it works:

• You receive a Partner ID and API Key when you onboard with Verso
• You create Tenants to represent each of your clients
• You access each tenant's payroll data using the route pattern: /partners/{partnerId}/tenants/{tenantId}/...
• Tenant boundaries must be preserved and verified on your environment

Ressources techniques

Les noms techniques de la référence API ne définissent pas les profils pris en charge. Les conditions et l’état de qualification sont dans le registre public.

Ressource	Rôle dans le périmètre visé
Users	Comptes utilisés pour accéder au dossier
Employees	Enregistrement technique du mandataire ; ce nom ne qualifie pas un contrat de travail
Cases	Données de calcul ; seules les variables du périmètre qualifié sont utilisables
Payruns	Exécution du calcul sur un dossier et une période
Results	Résultats détaillés ; restitution du bulletin et disponibilité à vérifier séparément

Real vs Forecast Mode

La référence technique distingue deux modes de calcul ; aucun ne vaut à lui seul validation réglementaire, déclaration ou paiement.

Mode	Description	Use Case
Real	Résultats enregistrés dans l’historique du moteur	Paies successives sur un dossier qualifié
Forecast	Simulation distincte des résultats enregistrés	Essais et comparaison de scénarios

Learn more in Real vs Forecast Mode. A forecast does not establish the qualification of cumulative payroll or the readiness of declaration and payment.

Getting Started

1. Get API Access

Contact us at [email protected] to obtain your API Key.

2. Authenticate

All API requests require authentication. Include your API key in the request headers:

Code
Authorization: Bearer YOUR_API_KEY

See Authentication for details.

3. Run Your First Payroll

Read Scope and prerequisites, then use the technical Quickstart in an authorized test environment.

Resources

Resource	Description
Quickstart	Complete 5-step workflow tutorial
Authentication	API key and security guide
Interactive API Reference	Try API calls in your browser
Postman Collection	Pre-configured workflow for testing

Documentation

Guides

• Real vs Forecast Mode - Understanding execution modes
• OData Queries - Filtering, sorting, and pagination
• Error Handling - Understanding and resolving errors

Reference

• Case Fields - Complete list of payroll input fields
• Error Codes - API error code reference

API Endpoints Overview

All Verso API endpoints follow the partner route pattern:

Method	Endpoint	Description
POST	/partners/{partnerId}/tenants/{tenantId}/users	Create a user
POST	/partners/{partnerId}/tenants/{tenantId}/employees	Create an employee
POST	/partners/{partnerId}/tenants/{tenantId}/payrolls/{id}/cases	Add payroll case values
POST	/partners/{partnerId}/tenants/{tenantId}/payruns/jobs	Start payrun calculation
GET	/partners/{partnerId}/tenants/{tenantId}/payrollresults/sets	Get detailed results

For the complete API documentation, visit the API Reference.