Authentification

L'API Chorus Pay utilise des clés API pour authentifier les requêtes.

Clés API

Vos clés API vous permettent d'accéder à l'API Chorus Pay. Vous pouvez gérer vos clés depuis l'interface fournisseur dans la section Paramètres → Clés API.

Les clés API commencent par sk_live_ en production et sk_test_ en test.

Gardez vos clés secrètes

Ne partagez jamais vos clés API et ne les exposez jamais côté client (JavaScript, applications mobiles). Stockez-les de manière sécurisée en tant que variables d'environnement.

Headers requis

Chaque requête à l'API doit inclure les en-têtes suivants :

AuthorizationRequis

Votre clé API sous forme de Bearer token

Authorization: Bearer "sk_live_1234567890abcdefghijklmnopqrstuvwxyz"

Content-TypeRequis

Le format des données envoyées (toujours JSON)

Content-Type: application/json

Idempotency-KeyOptionnel

Clé unique pour garantir l'idempotence des requêtes POST

Idempotency-Key: unique_key_123456

Exemples

cURL

curl -X GET https://chorus-pay.fr/api/v1/pay-links \
  -H "Authorization: Bearer sk_live_1234567890abcdefghijklmnopqrstuvwxyz" \
  -H "Content-Type: application/json"

JavaScript (fetch)

const response = await fetch('https://chorus-pay.fr/api/v1/pay-links', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer sk_live_1234567890abcdefghijklmnopqrstuvwxyz',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();

Python (requests)

import requests

headers = {
    'Authorization': 'Bearer sk_live_1234567890abcdefghijklmnopqrstuvwxyz',
    'Content-Type': 'application/json'
}

response = requests.get(
    'https://chorus-pay.fr/api/v1/pay-links',
    headers=headers
)

data = response.json()

Node.js (axios)

const axios = require('axios');

const response = await axios.get('https://chorus-pay.fr/api/v1/pay-links', {
  headers: {
    'Authorization': 'Bearer sk_live_1234567890abcdefghijklmnopqrstuvwxyz',
    'Content-Type': 'application/json'
  }
});

const data = response.data;

Erreurs d'authentication

Si votre clé API est invalide ou manquante, vous recevrez une erreur 401 :

{
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "La clé API fournie est invalide",
    "doc_url": "https://chorus-pay.fr/doc/errors#invalid_api_key"
  }
}