Desarrolladorv1

CargaCell API

Integra tu sistema de revendedor con CargaCell mediante HTTP. Crea una clave API desde tu perfil y autentica las solicitudes servidor a servidor con la cabecera x-api-key.

URL basehttps://www.cargacell.com/api/v1
Obtener clave API →

Inicio rápido

Autenticación con clave API

Envía tu clave en la cabecera x-api-key en cada solicitud. Utiliza claves separadas para los entornos de prueba y producción.

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

Comportamiento de la lista blanca IP

  • 0Cualquier IP está permitida — valor por defecto para claves nuevas.
  • ≥1Solo esas direcciones exactas son aceptadas.
  • RevocarLa clave deja de funcionar inmediatamente; crea una nueva.

Sandbox para desarrolladores

Crea una clave cc_test_ desde tu perfil. Utiliza un saldo ficticio aislado y nunca envía recargas a un proveedor real. El formato es igual al modo producción, por lo que solo tendrás que cambiar la clave.

Saldo de prueba

Añade 10, 50, 100 o 500 € desde tu perfil. El saldo máximo es de 1.000 € y las recargas están limitadas a cinco por hora.

Resultados predecibles

...0002 se rechaza, ...0003 queda procesando durante 10 segundos, ...0004 simula un tiempo de espera; los demás números tienen éxito.

Las solicitudes de prueba están limitadas a 10 por minuto por clave y 20 unidades de recarga por solicitud.

Referencia de endpoints

Todas las rutas son relativas a la URL base indicada arriba.

Autenticación

Valida la clave API y consulta la cuenta asociada.

MétodoRutaDescripción
GET/auth/meObtener usuario autenticado actual

Catálogo

Consulta los países, operadores y productos de recarga disponibles para tu integración.

MétodoRutaDescripción
GET/catalog/countriesListar países disponibles
GET/catalog/operatorsListar operadores disponibles
GET/catalog/recharge-productsCatálogo de recargas con filtros

Operaciones para revendedores

Envía recargas y consulta el saldo y el historial disponibles para clientes con clave API.

MétodoRutaDescripción
POST/api-access/b2b/rechargesRecarga B2B dedicada con monedero
GET/payments/historyHistorial de pagos
GET/wallet/balanceSaldo actual del monedero
GET/api-access/sandboxConsultar saldo de prueba y estados de recargas simuladas

Ejemplos de código

Ejemplos en vivo que reflejan el comportamiento actual del backend. Alterna entre Solicitud y Respuesta en cada tarjeta.

Verificar tu clave

Envía una solicitud GET para confirmar que la autenticación funciona e inspeccionar la cuenta asociada a la clave.

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

Listar productos con detalles de promoción

Obtén el catálogo de recargas. Los productos con promociones activas o programadas incluyen los detalles completos de la promo (nombre, descripción y términos opcionales).

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"

Recarga B2B por monedero

Endpoint B2B dedicado — omite MONEI completamente y despacha inmediatamente con saldo aprobado del monedero.

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

Consultar saldo y operaciones de prueba

Consulta el saldo ficticio y los últimos estados de recargas simuladas con una clave de prueba.

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

Flujos de recarga

Utiliza el endpoint dedicado para revendedores tanto en pruebas como en producción.

1

Recarga B2B por monedero

Llama a POST /api-access/b2b/recharges con una clave API de prueba o producción y una Idempotency-Key única. Las claves de prueba simulan la operación; las de producción descuentan el monedero y ponen la recarga en cola si hay saldo suficiente.

Las solicitudes de producción son procesadas por el despachador de recargas o quedan en espera cuando aplica una promoción de DT One.

Gestión de claves

Todas las operaciones con claves están disponibles en Panel → Perfil.

1

Crear

Crea una clave con nombre para cada integración o entorno. El valor en texto plano se muestra solo una vez en el momento de creación — cópialo inmediatamente.

2

Restringir

Añade entradas a la lista blanca de IP para bloquear una clave a infraestructura fija — puertas de enlace de oficina, servidores worker o IPs de salida de funciones cloud.

3

Revocar

Revoca las claves comprometidas o no utilizadas inmediatamente. La revocación tiene efecto al instante. Nunca reutilices claves antiguas — genera una nueva.

InicioCheckoutAcceder