Documentation complète des APIs exposées par l'application pour vendre vos billets directement depuis votre application ou votre site web. Vous ne pouvez vendre que les billets des événements que vous publiez ici.

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 : 6xxxxxxxx
• ticket_code (string, 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)
• promo_code (facultatif, string)

Réponses possibles :

• 200 : { "success": "Payment successful!" }, { "pending": "Transaction is already pending!" }
• 400 : { "message": "Insufficient funds!" } ou { "error": "Payment failed!" }
• 500 : { "message": "Impossible transaction!" }

Données : :

"data": {
    "transaction_id": 123456,
    "reference": "n_123456789",
    "amount": 100,
    "email": "user@example.com",
    "phone": "123456789",
    "name": "Netticket user",
    "owner": "Owner Name",
    "owner_email": "owner@example.com"
}

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_code (string, obligatoire)
• quantity (integer, facultatif, défaut 1)
• name (string, facultatif)
• notification (boolean, facultatif, défaut true)

Réponses possibles :

• 200 : { "success": "Payment successful!" }, { "pending": "Transaction is already pending!" }
• 400 : { "message": "Insufficient funds!" } ou { "error": "Payment failed!" }
• 500 : { "message": "Impossible transaction!" }

Données : :

"data": {
    "transaction_id": 123456,
    "reference": "n_123456789",
    "amount": 100,
    "email": "user@example.com",
    "phone": "123456789",
    "name": "Netticket user",
    "owner": "Owner Name",
    "owner_email": "owner@example.com"
}

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!" }