Astral4partner
Devenir partenaire

DÉVELOPPEURS

Astral4Gamer Partner API

API publique pour les partenaires développeurs. Montants en unités mineures (entiers) avec devise ISO. Sandbox : clés a4g_test_…, fournisseurs simulés. Player ID magiques : 000000001 = succès, 000000002 = échec, 000000003 = timeout puis succès.

Authentification

En-tête Authorization: Bearer a4g_live_… ou a4g_test_… (sandbox). Clés créées dans le dashboard, portées et liste d’IP autorisées.

Idempotence

Tous les POST exigent un en-tête Idempotency-Key : rejouer la même clé renvoie la réponse d’origine, sans double débit.

Webhooks

Signés dans l’en-tête A4G-Signature (t=…, v1=HMAC-SHA256). Réessais exponentiels en cas d’échec.

Spécification OpenAPI 3.1.0 : /v1/openapi.json · version 1.0.0

Catalogue

  • get/v1/gamesLister les jeux
  • get/v1/productsLister les produits (prix Astral)
  • get/v1/products/{id}Détail produit

Commandes

  • post/v1/player/checkVérifier un joueur (pseudo)Idempotency-Key
  • post/v1/ordersCréer une commande (débit du wallet prépayé)Idempotency-Key
  • get/v1/ordersLister les commandes API
  • get/v1/orders/{id}Statut d’une commande

Wallet

  • get/v1/wallet/balanceSolde du wallet prépayé
  • get/v1/transactionsMouvements du wallet (grand livre)

Webhooks

  • post/v1/webhooks/testEnvoyer un événement de test à vos endpointsIdempotency-Key

Événements webhook

  • order.completed