Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.oneclickdz.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Introduction

Intégrez la vente de cartes cadeaux et de produits numériques en 5 étapes simples. Cette vue d’ensemble explique le flux de travail-l’implémentation détaillée avec des exemples de code se trouve dans les guides étape par étape ci-dessous.
Les commandes de cartes cadeaux sont traitées en quelques secondes et les codes de carte sont livrés numériquement via l’API.

​
Comment ça fonctionne

​
Processus d’intégration en 5 étapes

1

Charger le catalogue

Récupérez les produits disponibles organisés par catégories (Gaming, Streaming, etc.). → Voir Étape 1 : Chargement du catalogue
2

Vérifier le produit

Obtenez les dénominations, les tarifs et le stock en temps réel pour un produit spécifique. → Voir Étape 2 : Vérification des produits
3

Passer une commande

Soumettez la commande avec l’ID produit, l’ID type (dénomination) et la quantité. → Voir Étape 3 : Passage de commandes
4

Suivre le statut

Interrogez le statut de la commande toutes les 5 à 10 secondes jusqu’à la complétion. → Voir Étape 4 : Suivi du statut
5

Livrer les cartes

Récupérez les codes/numéros de série et livrez-les en toute sécurité au client. → Voir Étape 5 : Livraison sécurisée

​
Ce que vous devez savoir

​
Structure des produits

  • Catalogue → Catégories (Gaming, Streaming, etc.)
  • Produits → Articles individuels (PUBG, Netflix, etc.)
  • Types → Dénominations (500 DA, 1000 DA, etc.)
→ Structure du catalogue à l’Étape 1

​
Statut de commande

  • HANDLING → Continuez à interroger
  • FULFILLED → Toutes les cartes livrées ✅
  • PARTIALLY_FILLED → Certaines cartes livrées, le reste remboursé ⚠️
  • REFUNDED → Commande échouée, remboursement émis ❌
→ Gestion des statuts à l’Étape 4

​
Exécution partielle

Si vous commandez 5 cartes mais seulement 3 sont disponibles, vous recevrez :
  • 3 cartes livrées
  • Facturé uniquement pour 3
  • Remboursé pour 2 automatiquement
Vérifiez toujours fulfilled_quantity par rapport à quantity. → Gestion des partiels à l’Étape 4

​
Tarification

Appliquez votre marge sur les prix de gros avant d’afficher aux clients. Exemple : 490 DA en gros → Vendez à 515 DA (5% de marge) → Profit : 25 DA → Tarification à l’Étape 2

​
Points clés

Vérifier le stock

Vérifiez available: true avant d’afficher les produits → Étape 2

Mettre en cache le catalogue

Mettez en cache le catalogue pendant +24 heures pour réduire les appels API → Étape 1

Gérer les partiels

Vérifiez la quantité exécutée par rapport à la quantité demandée → Étape 4

Chiffrer les cartes

Ne stockez jamais les codes de carte en texte clair → Étape 5

​
Référence API

Obtenir le catalogue

GET /v3/gift-cards/catalog

Vérifier le produit

GET /v3/gift-cards/checkProduct/:id

Passer une commande

POST /v3/gift-cards/placeOrder

Vérifier la commande

GET /v3/gift-cards/checkOrder/:id

​
Tests

Utilisez le mode sandbox pour tester sans dépenser de balance réelle :
  • TEST_REFUND (type ID) → Simule une commande échouée
  • TEST_PARTIAL (type ID) → Simule une exécution à 50%
Activez le sandbox dans les paramètres du tableau de bord.

​
Commencer l’intégration

Commencer avec l'Étape 1 : Chargement du catalogue

Commencez par charger le catalogue de produits avec des exemples de code

​
Ressources supplémentaires

Guide de démarrage rapide

Démarrez en 5 minutes

Authentification

Apprenez à authentifier les requêtes

Meilleures pratiques de sécurité

Sécurisez votre intégration

Contacter le support

Obtenez l’aide de notre équipe