Documentation complète des APIs exposées par l'application pour vendre vos tickets directement depuis votre application ou votre site web.

Authentification

Toutes les routes API sont sécurisées et nécessitent l'en-tête HTTP suivant :

x-api-key: VOTRE_TOKEN_API

(Voir votre API key dans vos paramètres de compte). Assurez-vous d'inclure cet en-tête dans toutes vos requêtes pour accéder aux fonctionnalités de l'API.

Base URL

https://netticket.net/api/$endpoint

Endpoints

GET get/{event_reference}/tickets

Récupère les tickets de votre événement.

• Paramètre URL : event_reference

Réponse réussie :

{
    "tickets": [
        {
        "id": ..., 
        "name": ..., 
        "price": ..., 
        "description": ..., 
        "stock": ..., 
        "x_refund": ..., 
        "x_active": ...
        },
        ...
    ]
}

Erreur :

{ "message": "Event not found!" }

Note : Vous devez être le propriétaire de l'événement.

POST /payment/mobile

Crée un paiement mobile.

• email (string, obligatoire)
• phone (integer, obligatoire), Exemple : 670495858
• ticket_id (numeric, obligatoire)
• modality (integer, obligatoire, valeurs : 1 pour Gratuit, 3 pour MTN Mobile Money, 4 pour Orange Money)
• quantity (integer, facultatif, défaut 1)
• name (string, facultatif)
• notification (boolean, facultatif, défaut true)

Réponses possibles :

• 200 : { "success": "Payment successful!" }
• 400 : { "message": "Insufficient funds!" } ou { "error": "Payment failed!" }
• 500 : { "message": "Service unavailable!" }

Condition : le ticket et l'événement doivent être actifs, l'événement doit appartenir à l'utilisateur authentifié et la date de fin ne doit pas être passée.

POST /payment/card

Créer un paiement par carte bancaire.

• email (string, obligatoire)
• card_number (string, obligatoire)
• card_expiration (string, obligatoire), au format MM / AA
• card_cvv (string, obligatoire)
• phone (numeric, facultatif)
• ticket_id (numeric, obligatoire)
• quantity (integer, facultatif, défaut 1)
• name (string, facultatif)
• notification (boolean, facultatif, défaut true)

Réponses possibles :

• 200 : { "success": "Payment successful!" }
• 400 : { "message": "Insufficient funds!" } ou { "error": "Payment failed!" }
• 500 : { "message": "Service unavailable!" }

GET /payment/{transaction_id}/check

Vérifie l'état d'un paiement.

• Paramètre URL : transaction_id

Réponses possibles :

• 200 : { "success": "Transaction successful" }
• 400 : { "error": "Transaction failed" }

POST /promotion/apply

Applique un code promotionnel à un événement.

• code (string, obligatoire)
• even_reference (string, obligatoire)
• amount (numeric, obligatoire)

Réponses possibles :

• 200 :

  {
  'success' => "message de succès",
  'discount' => ...,
  'discount_amount_formatted' => ...,
  'final_amount_formatted' => ...,
  'final_amount' => ...
  }

• 400 : { "error": "Echec de l'application du code promotionnel!" }