Developerv1

CargaCell API

Integrate your reseller system with CargaCell over HTTP. Create an API key from your profile and authenticate server-to-server requests with the x-api-key header.

Base URLhttps://www.cargacell.com/api/v1
Get API key →

Quick start

API key authentication

Send your key in the x-api-key header on every request. Use separate test and live keys for each environment.

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

IP whitelist behavior

  • 0Every IP is allowed — default for new keys.
  • ≥1Only those exact addresses are accepted.
  • RevokeKey stops working immediately; create a new one.

Developer sandbox

Create a cc_test_ key from your profile. It uses isolated fake balance and never dispatches to a real provider. The request format is the same as live mode, so production only requires replacing the key.

Test balance

Add €10, €50, €100, or €500 from your profile. Balance is capped at €1,000 and additions are limited to five per hour.

Predictable outcomes

...0002 rejects, ...0003 processes for 10 seconds, ...0004 simulates a timeout; other numbers succeed.

Test recharge requests are limited to 10 per minute per key and 20 recharge units per request.

Endpoint reference

All paths are relative to the base URL above.

Authentication

Validate the API key and inspect its associated account.

MethodPathDescription
GET/auth/meGet current authenticated user

Catalog

Browse the countries, operators, and recharge products available to your integration.

MethodPathDescription
GET/catalog/countriesList available countries
GET/catalog/operatorsList available operators
GET/catalog/recharge-productsRecharge catalog with filters

Reseller operations

Submit recharges and inspect the balance and operation history available to API-key clients.

MethodPathDescription
POST/api-access/b2b/rechargesB2B dedicated wallet-funded recharge
GET/payments/historyPayment history
GET/wallet/balanceCurrent wallet balance
GET/api-access/sandboxRead test balance and simulated recharge statuses

Code examples

Live examples mirroring the current backend behavior. Toggle between Request and Response in each card.

Verify your key

Send a GET request to confirm authentication is working and inspect the account the key belongs to.

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

List products with promo details

Fetch the recharge catalog. Products with active or scheduled promotions include full promo details (name, description, optional terms).

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"

B2B wallet recharge

Dedicated B2B endpoint — skips MONEI entirely and dispatches immediately from approved wallet balance.

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

Read sandbox balance and operations

Inspect fake balance and the latest simulated recharge statuses with a test key.

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

Recharge flows

Use the dedicated reseller endpoint in both test and live environments.

1

B2B wallet recharge

Call POST /api-access/b2b/recharges with a test or live API key and a unique Idempotency-Key. Test keys simulate the operation; live keys debit the reseller wallet and queue the recharge when balance is sufficient.

Live requests are dispatched by the recharge processor, or marked as waitlisted when a DT One promotion window applies.

Managing keys

All key operations are available in Dashboard → Profile.

1

Create

Create a named key for each integration or environment. The plaintext value is shown only once at creation time — copy it immediately.

2

Restrict

Add IP whitelist entries to lock a key to fixed infrastructure — office gateways, worker servers, or cloud function egress IPs.

3

Revoke

Revoke compromised or unused keys immediately. Revocation takes effect instantly. Never reuse old keys — generate a fresh one instead.

HomeCheckoutLog in