Ontwikkelaarv1

CargaCell API

Dezelfde backend als de webapplicatie is beschikbaar via HTTP. Maak een API-sleutel aan in uw profiel en authenticeer server-naar-server-verzoeken met de x-api-key-header.

Basis-URLhttps://www.cargacell.com/api/v1

API-sleutel ophalen →

Snel starten

API-sleutelauthenticatie

Stuur uw sleutel in de x-api-key-header bij elk verzoek. JWT-browsersessies blijven parallel werken voor webclients.

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

IP-whitelist-gedrag

0Elk IP is toegestaan — standaard voor nieuwe sleutels.
≥1Alleen die exacte adressen worden geaccepteerd.
IntrekkenDe sleutel stopt onmiddellijk met werken; maak een nieuwe aan.

Endpoint-referentie

Alle paden zijn relatief aan de bovenstaande basis-URL.

Endpoints gemarkeerd als Alleen web vereisen een browsersessietoken en weigeren x-api-key-authenticatie.

Authenticatie

Valideer de sleutel en lees of update het huidige accountprofiel.

Methode	Pad	Beschrijving
POST	/auth/login	Aanmelden met e-mail en wachtwoord
GET	/auth/me	Huidige geauthenticeerde gebruiker ophalen
PATCH	/auth/me	Profiel en facturatiegegevens bijwerken

Catalogus & winkelwagen

Blader door operators en producten, stel daarna bestellingen samen voor betaling.

Methode	Pad	Beschrijving
GET	/catalog/countries	Beschikbare landen weergeven
GET	/catalog/operators	Beschikbare operators weergeven
GET	/catalog/recharge-products	Opwaardeer-catalogus met filters
GET	/cart	Huidige winkelwagen ophalen
POST	/cart/items	Artikel toevoegen aan winkelwagen
DELETE	/cart/items/:itemId	Artikel verwijderen uit winkelwagen

Betalingen & portemonnee

Bereken prijzen en verstuur opwaarderingen met portemonnee-saldo. Externe checkout is alleen voor websessies.

Methode	Pad	Beschrijving	Tags
POST	/payments/quote	Prijsofferte opvragen
POST	/payments/prepare	Webcheckout-invoer valideren	Alleen web
POST	/payments/checkout	Externe webcheckout afronden	Alleen web
GET	/payments/history	Betalingsgeschiedenis
GET	/wallet/balance	Huidig portemonnee-saldo
POST	/wallet/checkout	Portemonnee-gefinancierde opwaarderingen versturen
POST	/api-access/b2b/recharges	Toegewijde B2B-portemonnee-opwaardering	B2B

Beheer

Beheerdersaccounts kunnen hetzelfde API-sleutelmechanisme gebruiken voor alle back-office-endpoints.

Methode	Pad	Beschrijving	Tags
GET	/admin/summary	Dashboard-samenvatting	Admin
GET	/admin/users	Gebruikersbeheer	Admin
GET	/admin/recharges	Opwaardeeroperaties	Admin
GET	/admin/payments	Betalingsoperaties	Admin
GET	/admin/products	Catalogusoperaties	Admin

Codevoorbeelden

Live voorbeelden die het huidige backendgedrag weerspiegelen. Wissel tussen Verzoek en Reactie in elke kaart.

Uw sleutel verifiëren

Stuur een GET-verzoek om te bevestigen dat authenticatie werkt en het bijbehorende account te inspecteren.

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

Producten weergeven met promotiedetails

Haal de opwaardeer-catalogus op. Producten met actieve of geplande promoties bevatten volledige promo-details (naam, beschrijving, optionele voorwaarden).

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"

Artikel toevoegen aan winkelwagen

Voeg een ontvangersregel toe aan de winkelwagen. Haal eerst de productcatalogus op om een geldig productId te vinden.

curl -X POST \
  https://www.cargacell.com/api/v1/cart/items \
  -H "Content-Type: application/json" \
  -H "x-api-key: cc_live_your_generated_key" \
  -d '{
    "sessionId": "agent-session-001",
    "productId": "12345",
    "recipientNumber": "+5355512345",
    "quantity": 2
  }'

B2B-portemonnee-opwaardering

Toegewijd B2B-endpoint — slaat MONEI volledig over en verstuurt onmiddellijk vanuit het goedgekeurde portemonnee-saldo.

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

Generieke portemonnee-checkout

Standaard portemonnee-gefinancierde checkout — werkt met API-sleutels en websessies.

curl -X POST \
  https://www.cargacell.com/api/v1/wallet/checkout \
  -H "Content-Type: application/json" \
  -H "x-api-key: cc_live_your_generated_key" \
  -d '{
    "items": [
      {
        "productId": "12345",
        "recipientNumber": "+5355512345",
        "quantity": 1
      }
    ],
    "baseCurrency": "EUR"
  }'

Opwaarderingen weergeven (beheerder)

Beheerder-API-sleutels kunnen back-office-endpoints aanroepen met dezelfde x-api-key-header.

curl -X GET \
  "https://www.cargacell.com/api/v1/admin/recharges?page=1&limit=20" \
  -H "x-api-key: cc_live_admin_key"

Opwaardeerstromen

Er zijn drie verzendpaden. Kies het pad dat past bij uw integratie.

Externe betalingscheckout

Alleen web

De browser initieert een MONEI-betaling via POST /payments/prepare, bevestigt daarna na autorisatie via POST /payments/checkout. Vereist een JWT-websessie. API-sleutels worden geweigerd.

Portemonnee-checkout

Roep POST /wallet/checkout aan met uw artikelen. De backend berekent het beschikbare saldo uit goedgekeurde opwaarderingen minus vastgelegde portemonnee-betalingen en weigert als het onvoldoende is. Werkt met API-sleutels en websessies.

B2B-portemonnee-opwaardering

B2B

Roep POST /api-access/b2b/recharges aan. Gebruikt dezelfde portemonnee-engine als pad 2, maar is speciaal gebouwd voor API-sleutelclients die nooit mogen interacteren met de MONEI-stroom. Verstuurt onmiddellijk als het saldo voldoende is.

In alle portemonnee-gefinancierde paden creëert een geslaagde betaling rijen in de opwaardeerwachtrij. Deze worden verwerkt door de opwaardeerprocessor, of als wachtend gemarkeerd wanneer een DT One-promotievenster van toepassing is.

Sleutelbeheer

Alle sleuteloperaties zijn beschikbaar in Dashboard → Profiel.

Aanmaken

Maak een benoemde sleutel aan voor elke integratie of omgeving. De platte tekst-waarde wordt slechts eenmaal weergegeven bij aanmaak — kopieer deze onmiddellijk.

Beperken

Voeg IP-whitelist-vermeldingen toe om een sleutel te vergrendelen op vaste infrastructuur — kantoorgateway, workerservers of cloud-functie-uitgangs-IP's.

Intrekken

Trek gecompromitteerde of ongebruikte sleutels onmiddellijk in. Intrekking heeft onmiddellijk effect. Gebruik oude sleutels nooit opnieuw — genereer in plaats daarvan een nieuwe.