Développeurv1

CargaCell API

Intégrez votre système de revendeur à CargaCell via HTTP. Créez une clé API depuis votre profil et authentifiez les requêtes serveur à serveur avec l'en-tête x-api-key.

URL de basehttps://www.cargacell.com/api/v1
Obtenir une clé API →

Démarrage rapide

Authentification par clé API

Envoyez votre clé dans l'en-tête x-api-key à chaque requête. Utilisez des clés distinctes pour les environnements de test et de production.

curl -X GET \
  https://www.cargacell.com/api/v1/auth/me \
  -H "x-api-key: cc_test_your_key"

Comportement de la liste blanche IP

  • 0Toutes les IP sont autorisées — valeur par défaut pour les nouvelles clés.
  • ≥1Seules ces adresses exactes sont acceptées.
  • RévoquerLa clé cesse de fonctionner immédiatement ; créez-en une nouvelle.

Sandbox développeur

Créez une clé cc_test_ depuis votre profil. Elle utilise un solde fictif isolé et n'envoie jamais de recharge à un fournisseur réel. Le format est identique au mode production : il suffit de remplacer la clé.

Solde de test

Ajoutez 10, 50, 100 ou 500 € depuis votre profil. Le solde est plafonné à 1 000 € et les ajouts sont limités à cinq par heure.

Résultats prévisibles

...0002 est rejeté, ...0003 reste en traitement pendant 10 secondes, ...0004 simule un délai d'expiration ; les autres numéros réussissent.

Les requêtes de recharge de test sont limitées à 10 par minute et par clé, avec 20 unités de recharge par requête.

Référence des endpoints

Tous les chemins sont relatifs à l'URL de base ci-dessus.

Authentification

Validez la clé API et consultez le compte associé.

MéthodeCheminDescription
GET/auth/meObtenir l'utilisateur authentifié actuel

Catalogue

Consultez les pays, opérateurs et produits de recharge disponibles pour votre intégration.

MéthodeCheminDescription
GET/catalog/countriesLister les pays disponibles
GET/catalog/operatorsLister les opérateurs disponibles
GET/catalog/recharge-productsCatalogue de recharges avec filtres

Opérations revendeur

Envoyez des recharges et consultez le solde et l'historique accessibles aux clients API.

MéthodeCheminDescription
POST/api-access/b2b/rechargesRecharge B2B dédiée par portefeuille
GET/payments/historyHistorique des paiements
GET/wallet/balanceSolde actuel du portefeuille
GET/api-access/sandboxConsulter le solde de test et les statuts des recharges simulées

Exemples de code

Exemples en direct reflétant le comportement actuel du backend. Basculez entre Requête et Réponse dans chaque carte.

Vérifier votre clé

Envoyez une requête GET pour confirmer que l'authentification fonctionne et inspecter le compte associé à la clé.

curl -X GET \
  https://www.cargacell.com/api/v1/auth/me \
  -H "x-api-key: cc_live_your_generated_key" \
  -H "Accept-Language: en"

Lister les produits avec les détails promo

Récupérez le catalogue de recharges. Les produits avec des promotions actives ou planifiées incluent les détails complets (nom, description, conditions optionnelles).

curl -X GET \
  "https://www.cargacell.com/api/v1/catalog/recharge-products?country=ES&limit=5" \
  -H "x-api-key: cc_live_your_generated_key" \
  -H "Accept-Language: en"

Recharge B2B par portefeuille

Endpoint B2B dédié — contourne MONEI entièrement et envoie immédiatement depuis le solde approuvé du portefeuille.

curl -X POST \
  https://www.cargacell.com/api/v1/api-access/b2b/recharges \
  -H "Content-Type: application/json" \
  -H "x-api-key: cc_test_your_generated_key" \
  -H "Idempotency-Key: reseller-order-1001" \
  -d '{
    "items": [
      {
        "productId": "12345",
        "recipientNumber": "+5355512345",
        "quantity": 2
      }
    ],
    "baseCurrency": "EUR"
  }'

Lire le solde et les opérations de test

Consultez le solde fictif et les derniers statuts de recharge simulés avec une clé de test.

curl -X GET \
  https://www.cargacell.com/api/v1/api-access/sandbox \
  -H "x-api-key: cc_test_your_generated_key"

Flux de recharge

Utilisez l'endpoint revendeur dédié dans les environnements de test et de production.

1

Recharge B2B par portefeuille

Appelez POST /api-access/b2b/recharges avec une clé API de test ou de production et une Idempotency-Key unique. Les clés de test simulent l'opération ; les clés de production débitent le portefeuille et mettent la recharge en file si le solde suffit.

Les requêtes de production sont traitées par le processeur de recharge ou mises en attente lorsqu'une promotion DT One s'applique.

Gestion des clés

Toutes les opérations sur les clés sont disponibles dans Tableau de bord → Profil.

1

Créer

Créez une clé nommée pour chaque intégration ou environnement. La valeur en clair n'est affichée qu'une seule fois à la création — copiez-la immédiatement.

2

Restreindre

Ajoutez des entrées à la liste blanche IP pour verrouiller une clé à une infrastructure fixe — passerelles de bureau, serveurs workers ou IPs de sortie de fonctions cloud.

3

Révoquer

Révoquez immédiatement les clés compromises ou inutilisées. La révocation prend effet instantanément. Ne réutilisez jamais les anciennes clés — générez-en une nouvelle.

AccueilPaiementConnexion