Sviluppatorev1

CargaCell API

Integra il tuo sistema rivenditore con CargaCell via HTTP. Crea una chiave API dal tuo profilo e autentica le richieste server-to-server con l'header x-api-key.

URL basehttps://www.cargacell.com/api/v1
Ottieni chiave API →

Avvio rapido

Autenticazione con chiave API

Invia la tua chiave nell'header x-api-key ad ogni richiesta. Usa chiavi separate per gli ambienti di test e produzione.

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

Comportamento whitelist IP

  • 0Qualsiasi IP è consentito — predefinito per le nuove chiavi.
  • ≥1Solo quegli indirizzi esatti sono accettati.
  • RevocaLa chiave smette di funzionare immediatamente; creane una nuova.

Sandbox per sviluppatori

Crea una chiave cc_test_ dal tuo profilo. Usa un saldo fittizio isolato e non invia mai ricariche a un provider reale. Il formato è uguale a quello live: in produzione devi solo sostituire la chiave.

Saldo di test

Aggiungi 10, 50, 100 o 500 € dal tuo profilo. Il saldo è limitato a 1.000 € e le aggiunte sono limitate a cinque all'ora.

Risultati prevedibili

...0002 viene rifiutato, ...0003 resta in elaborazione per 10 secondi, ...0004 simula un timeout; gli altri numeri hanno successo.

Le richieste di ricarica di test sono limitate a 10 al minuto per chiave e 20 unità di ricarica per richiesta.

Riferimento endpoint

Tutti i percorsi sono relativi all'URL base indicato sopra.

Autenticazione

Valida la chiave API e consulta l'account associato.

MetodoPercorsoDescrizione
GET/auth/meOttieni l'utente autenticato corrente

Catalogo

Consulta paesi, operatori e prodotti di ricarica disponibili per la tua integrazione.

MetodoPercorsoDescrizione
GET/catalog/countriesElenca i paesi disponibili
GET/catalog/operatorsElenca gli operatori disponibili
GET/catalog/recharge-productsCatalogo ricariche con filtri

Operazioni rivenditore

Invia ricariche e consulta saldo e cronologia disponibili ai client API.

MetodoPercorsoDescrizione
POST/api-access/b2b/rechargesRicarica B2B dedicata tramite portafoglio
GET/payments/historyCronologia pagamenti
GET/wallet/balanceSaldo portafoglio corrente
GET/api-access/sandboxConsultare saldo di test e stati delle ricariche simulate

Esempi di codice

Esempi live che rispecchiano il comportamento attuale del backend. Passa tra Richiesta e Risposta in ogni scheda.

Verifica la tua chiave

Invia una richiesta GET per confermare che l'autenticazione funziona e ispezionare l'account associato alla chiave.

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

Elenca prodotti con dettagli promo

Ottieni il catalogo ricariche. I prodotti con promozioni attive o programmate includono i dettagli completi della promo (nome, descrizione, termini opzionali).

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"

Ricarica B2B tramite portafoglio

Endpoint B2B dedicato — bypassa MONEI completamente e invia immediatamente dal saldo approvato del portafoglio.

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"
  }'

Leggi saldo e operazioni sandbox

Controlla il saldo fittizio e gli ultimi stati delle ricariche simulate con una chiave di test.

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

Flussi di ricarica

Usa l'endpoint dedicato ai rivenditori negli ambienti di test e produzione.

1

Ricarica B2B tramite portafoglio

Chiama POST /api-access/b2b/recharges con una chiave API di test o live e una Idempotency-Key univoca. Le chiavi di test simulano l'operazione; quelle live addebitano il portafoglio e accodano la ricarica se il saldo è sufficiente.

Le richieste live vengono elaborate dal processore di ricarica o messe in attesa quando si applica una promozione DT One.

Gestione chiavi

Tutte le operazioni sulle chiavi sono disponibili in Dashboard → Profilo.

1

Crea

Crea una chiave con nome per ogni integrazione o ambiente. Il valore in chiaro viene mostrato solo una volta al momento della creazione — copialo immediatamente.

2

Limita

Aggiungi voci alla whitelist IP per bloccare una chiave su infrastrutture fisse — gateway d'ufficio, server worker o IP di uscita di funzioni cloud.

3

Revoca

Revoca immediatamente le chiavi compromesse o inutilizzate. La revoca ha effetto istantaneamente. Non riutilizzare mai le chiavi vecchie — genera invece una nuova.

HomePagamentoAccedi