Documentation API Chorus Pay
L'API Chorus Pay vous permet d'intégrer la création et la gestion de devis pour les collectivités directement dans vos applications.
Simple et rapide
API RESTful intuitive avec des réponses JSON. Créez votre premier pay link en quelques minutes.
Sécurisé
Authentication par API key, webhooks signés HMAC-SHA256, et conformité aux standards de sécurité.
Extensible
Webhooks temps réel, metadata personnalisées, et configuration flexible pour s'adapter à vos besoins.
Quick Start
Voir AuthentificationCréer votre premier pay link
Un pay link génère automatiquement un devis et une page de checkout pour la collectivité.
curl -X POST https://chorus-pay.fr/api/v1/pay-links \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"amount": 62.00,
"description": "Élection représentants parents 2025",
"client": {
"name": "Mairie de Saint-Cloud",
"siret": "21092064000016",
"email": "finances@saintcloud.fr"
},
"items": [
{
"description": "Licence plateforme",
"quantity": 1,
"unit_price": 16.67
}
],
"metadata": {
"internal_ref": "REF-2025-001"
}
}'Réponse
{
"id": "pl_1234567890",
"status": "draft",
"amount": 62.00,
"quote_number": "01163",
"url": "https://checkout.chorus-pay.fr/pl_1234567890",
"client": {
"name": "Mairie de Saint-Cloud",
"siret": "21092064000016",
"email": "finances@saintcloud.fr"
},
"created_at": "2025-10-22T10:30:00Z",
"expires_at": "2025-11-22T10:30:00Z"
}Informations de base
Base URL
https://chorus-pay.fr/api/v1/Toutes les requêtes API doivent être préfixées par cette URL.
Authentication
Authorization: Bearer "YOUR_API_KEY"Authentifiez-vous en incluant votre clé API dans l'en-tête de chaque requête.
Le concept de Pay Link
Un Pay Link est une URL unique qui génère automatiquement :
- Un devis au format PDF avec votre branding
- Une page de checkout sécurisée pour la collectivité
- Un workflow complet : consultation → acceptation → génération du bon de commande
1 devis = 1 pay link : chaque pay link est unique et correspond à un devis spécifique.