API de Recharge Jeux & Applications
API unifiée et standard pour consulter le catalogue complet de produits numériques et effectuer des recharges instantanées pour tous les jeux, applications et services numériques pris en charge via SofizPay.
Flux d'Intégration Standard (Workflow)
La recharge de n'importe quel jeu ou application numérique suit un flux standardisé en deux étapes :
Consulter le Catalogue & les Tarifs
Appelez get_products pour récupérer tous les produits disponibles, les codes opérateurs (operator), les forfaits et les prix en DZD.
Exécuter la Recharge Standard
Appelez operation_post en transmettant le code opérateur, l'identifiant joueur/compte (Player ID) et le forfait choisi pour créditer l'utilisateur immédiatement.
1. Consultation des Produits & Tarifs
Récupérez le catalogue complet des produits numériques, applications et jeux avec leurs tarifs
https://sofizpay.com/services/get_products/Ce point retourne les produits disponibles filtrés par disponibilité, en renvoyant uniquement des informations simplifiées (nom et prix)
Paramètres de la Requête
Content-Type: application/json
| Paramètre | Type | Requis | Description |
|---|---|---|---|
encrypted_sk | string | Oui | Clé secrète SofizPay chiffrée ou en clair. Peut être une clé en clair commençant par "S" (56 caractères) ou une clé chiffrée RSA encodée en base64 |
search | string | Non | Terme de recherche optionnel pour filtrer les produits par nom |
Exemple de Requête
Exemple avec terme de recherche
curl -X GET "https://sofizpay.com/services/get_products/" \
-H "Content-Type: application/json" \
-d '{
"encrypted_sk": "SBXJ...",
"search": "PUBG"
}'Exemple sans terme de recherche (tous les produits)
curl -X GET "https://sofizpay.com/services/get_products/" \
-H "Content-Type: application/json" \
-d '{
"encrypted_sk": "SBXJ..."
}'Réponse de Succès (200)
Retourne une liste de produits disponibles avec leurs noms et prix en DZT
1{
2 "status": "success",
3 "count": 8,
4 "products": [
5 {
6 "name": "PUBG 1320 UC",
7 "price": "4743.24"
8 },
9 {
10 "name": "PUBG 1800 UC",
11 "price": "5929.05"
12 },
13 {
14 "name": "PUBG 325 UC",
15 "price": "1185.81"
16 },
17 {
18 "name": "Free Fire 1080 Diamonds",
19 "price": "2150.00"
20 }
21 ]
22}Champs de la Réponse
| Champ | Type | Description |
|---|---|---|
status | string | Statut de la réponse : "success" ou "error" |
count | integer | Nombre total de produits disponibles retournés |
products | array | Tableau d'objets produits |
products[].name | string | Nom du produit |
products[].price | string | Prix du produit en DZT |
Réponses d'Erreur
400 - JSON invalide
{
"status": "error",
"message": "Invalid JSON"
}400 - encrypted_sk est requis
{
"status": "error",
"message": "encrypted_sk is required"
}400 - Clé secrète invalide
{
"status": "error",
"message": "Invalid secret key"
}400 - Format de clé secrète invalide
{
"status": "error",
"message": "Invalid secret key format"
}500 - Erreur API externe
{
"status": "error",
"message": "Error fetching products: [error details]"
}Fonctionnalités
Notes techniques importantes :
- Tous les produits disponibles sont retournés si aucun terme de recherche n'est fourni
- Les prix sont retournés sous forme de chaînes pour éviter les problèmes de précision des nombres flottants
- Seuls les produits avec is_available: true sont inclus dans la réponse
- Le point utilise l'exemption CSRF pour faciliter l'intégration des clients
2. Exécution de la Recharge (Point de Terminaison Standard)
Point de terminaison universel conçu pour traiter les recharges pour tout produit numérique ou application
https://sofizpay.com/services/operation_postCe point de terminaison unifié gère les opérations de recharge pour tous les jeux et applications du catalogue
Spécification Standard Universelle pour Tous les Produits
Ce point de terminaison fonctionne de manière identique pour tous les produits du catalogue SofizPay. Il ne se limite pas à des titres spécifiques : fournissez simplement le code opérateur et l'identifiant utilisateur correspondant.
Structure de Requête Standard
Structure de requête standardisée pour tout jeu, application ou carte numérique :
curl --location 'https://sofizpay.com/services/operation_post' \
--header 'Content-Type: application/json' \
--data '{
"encrypted_sk": "YOUR_ENCRYPTED_SECRET_KEY OR PURE_SECRET_KEY",
"operator": "PRODUCT_OPERATOR_CODE",
"playerId": "TARGET_USER_OR_PLAYER_ID",
"amount": AMOUNT_IN_DZD,
"offer": "PACKAGE_OFFER_CODE"
}'Paramètres de Requête Standard
Content-Type: application/json
| Paramètre | Type | Description Standard |
|---|---|---|
encrypted_sk | string | Clé secrète chiffrée ou texte pour l'authentification |
operator | string | Code du produit ou opérateur issu du catalogue (ex: pubg, freefire ou tout autre produit) |
playerId | string | Identifiant joueur, compte ou utilisateur (Player ID / User ID / Account ID) |
amount | number | Montant de recharge en DZD correspondant au forfait sélectionné |
offer | string | Code d'offre prédéfini ou nom du forfait sélectionné |
Spécification de l'identifiant (playerId) selon le type de produit
Jeux mobiles & PC : Identifiant joueur dans le jeu (Player ID / UID).
Applications & plateformes numériques : Identifiant de compte, nom d'utilisateur ou ID profil.
Services numériques : Numéro de compte bénéficiaire ou identifiant lié au service.
Réponse de Succès Standard (200 OK)
{
"status": "success",
"message": "Operation completed successfully",
"operation_id": "OP_894321789",
"transaction_id": "TX_448921102",
"transaction_status": "confirmed"
}Remarque importante : L'opération est confirmée immédiatement et les crédits sont ajoutés directement au compte utilisateur.