API publique · V5.0.0
Référence technique pour une intégration de slots B2B
La référence publique actuelle comprend 17 points de terminaison, quatre schémas et huit FAQ. Elle prépare le périmètre technique sans exposer les URL réelles, identifiants ou configurations de production.
Domaines couverts
- Contenu, fournisseurs, catégories, jeux et sessions.
- Modèles de portefeuille unique et de transfert.
- Enregistrements, consultations contrôlées et identifiants opérationnels.
Catalogue des 17 capacités publiques
Catalogue et sessions
- Liste des fournisseurs
- Liste des catégories
- Liste paginée des jeux
- Création d’une session ou URL de jeu
- Déconnexion forcée du joueur
Portefeuille unique
- Consultation du solde
- Profil du joueur
- Mise
- Gain
- Règlement mise-gain
- Annulation d’ordre
Portefeuille de transfert, enregistrements et marchand
- Transfert vers le portefeuille de jeu
- Transfert de retour
- Solde du portefeuille de transfert
- Enregistrements de transaction
- Enregistrements de jeu
- Consultation contrôlée de la configuration marchand et du portefeuille
Modèle de requête et signature
L’API utilise JSON et POST, code marchand, horodatage, nonce et signature HMAC-SHA256.
POST https://{base-url}/game/v5/game/url
Content-Type: application/json
X-MERCHANT-CODE: {merchant-code}
X-TIMESTAMP: {timestamp}
X-NONCE: {nonce}
X-SIGN: {hmac-sha256-signature}
{ "reqTraceId": "trace-demo-001", "gameCode": "{game-code}",
"playerId": "player-demo-001", "currencyCode": "{currency-code}",
"language": "fr", "terminalType": "PC" }Calculez la signature à partir de la chaîne JSON finale. Les valeurs ci-dessus sont des espaces réservés publics, jamais des identifiants utilisables.
Quatre schémas à confirmer
- Enveloppe commune de requête et réponse
- Session de jeu et contexte joueur
- Transaction de portefeuille avec identifiants de corrélation
- Enregistrement de jeu ou de transaction pour le rapprochement
Les champs représentatifs incluent merchantCode, subMerchantCode, reqTraceId, transactionId, roundId, devise, montant et état. Les contraintes définitives sont fournies dans le paquet contrôlé.
FAQ technique
Pourquoi l’URL réelle n’est-elle pas publique ?
Elle est fournie avec les identifiants et les restrictions propres au projet après le parcours d’accès contrôlé.
Quel modèle de portefeuille choisir ?
Le portefeuille unique ou de transfert dépend de l’architecture et des responsabilités convenues ; les deux doivent être testés avec leurs exceptions.
Un délai d’attente signifie-t-il que la transaction a échoué ?
Non. Vérifiez l’opération initiale avec ses identifiants avant toute nouvelle tentative.
Comment éviter un doublon ?
Conservez un identifiant stable et appliquez l’idempotence côté responsable du registre.
Quels identifiants faut-il journaliser ?
Au minimum la trace de requête, transaction, manche, heure, résultat et lien avec l’opération initiale.
Les exemples sont-ils prêts pour la production ?
Non. Ils décrivent la forme de la requête et ne constituent pas une configuration de production.
Le catalogue public garantit-il un lancement ?
Non. Jeu, version, droits, devise, région et environnement sont confirmés par projet.
Comment traiter une récupération de fonds ou une configuration marchand ?
Ces capacités sont limitées à leur finalité publique ; leurs chemins et règles sont fournis dans la documentation contrôlée.