Aller au contenu principal

Documentation développeur

Intégrez billetfacile
à votre application.

Donnez accès aux événements, collectes et e-votes billetfacile depuis votre mini-app ou votre plateforme, avec vos propres parcours de paiement.

Commencer l'intégrationVoir la référence
AuthentificationJWT via Basic Auth
Format d'échangeJSON sur HTTPS
Base URL Sandboxapi-partner.sandboxbilletfacile.com
Premier appel authentifiecurl
curl -X GET \
  "https://api-partner.sandboxbilletfacile.com/v1/events/home" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Démarrage rapide

Votre premier parcours, en quatre étapes.

Les identifiants partenaire restent côté serveur. Ne les exposez jamais dans votre application cliente.

  1. 01
    Récupérez vos identifiants

    Demandez vos identifiants partenaire à l'équipe billetfacile.

    Voir les prérequis
  2. 02
    Obtenez un access token

    Votre backend échange les identifiants partenaire contre un JWT.

    Configurer l'authentification
  3. 03
    Affichez une offre

    Interrogez les filtres, puis les événements, collectes ou e-votes.

    Explorer la recherche
  4. 04
    Confirmez le paiement

    Initialisez chaque transaction, puis envoyez son résultat après encaissement. Seuls les billets sont réservés.

    Voir les transactions

Ressources API

Composez le parcours adapté à votre produit.

Chaque ressource est documentée avec ses paramètres, réponses et erreurs possibles.

CatalogueÉvénements

Recherchez, affichez les dates et choisissez les tarifs disponibles.

Consulter la ressourceDonCollectes

Affichez les campagnes puis initialisez le don avant paiement.

Consulter la ressourceParticipationE-votes

Exposez les scrutins puis initialisez le vote avant paiement.

Consulter la ressourceIdentitéCustomer

Provisionnez un client et retrouvez son historique de transactions.

Consulter la ressource

Commandes et paiement

Le paiement reste dans votre environnement.

Initialisez Ticket Order, Donation ou Poll Vote, puis encaissez dans votre environnement et notifiez l'API du résultat. Seul Ticket Order réserve les billets avant le paiement.

Voir le flux de transaction
  1. 1Initialiser

    Créez la transaction et conservez sa référence.

  2. 2Encaisser

    Traitez la transaction avec votre moyen de paiement.

  3. 3Confirmer

    Envoyez `paid` ou `failed` depuis votre backend.

Référence complète

Besoin du contrat détaillé ?

Retrouvez toutes les routes, les formats de requêtes et les codes d'erreur dans la documentation de référence.

Ouvrir la référence API