Integración para empresas

Automatiza recargas con la API B2B de Cargacell

Las empresas y revendedores pueden consultar el catálogo, proteger el acceso por clave e IP y enviar recargas utilizando saldo previamente aprobado.

Qué ofrece la integración

AutenticaciónClaves dedicadas mediante la cabecera x-api-key.
Control de accesoLista opcional de direcciones IP permitidas por clave.
CatálogoConsulta de productos y promociones disponibles.
OperacionesEnvío de una o varias recargas con seguimiento de estado.

Flujo B2B

  1. Crea una cuenta y solicita o genera una clave API desde el perfil.
  2. Configura una lista de IP si necesitas restringir el origen de las solicitudes.
  3. Consulta GET /api/v1/catalog/recharge-products para obtener productos vigentes.
  4. Mantén saldo aprobado suficiente en el monedero empresarial.
  5. Envía recargas mediante POST /api/v1/api-access/b2b/recharges o utiliza el checkout del monedero.

Saldo y despacho

El endpoint B2B utiliza saldo aprobado y evita el checkout de pago minorista para cada operación. Si el saldo disponible no cubre el importe calculado, la solicitud se rechaza antes del despacho.

Los identificadores de productos deben obtenerse del catálogo actual. No conviene almacenar indefinidamente productos o promociones, porque la disponibilidad puede cambiar.

Entorno de pruebas

Las claves con prefijo cc_test_ utilizan saldo ficticio y operaciones simuladas. Nunca envían recargas a un proveedor real. Puedes añadir saldo de prueba, reiniciar el entorno y consultar los resultados desde tu perfil.

El formato de las solicitudes es el mismo que en producción: para pasar al entorno real solo tienes que sustituir la clave de prueba por una clave cc_live_.

Documentación y acceso

La referencia técnica, los ejemplos de solicitudes y los endpoints disponibles están en la documentación pública de la API. Para hablar sobre volumen, incorporación o soporte de integración, utiliza la página de contacto.

Información revisada por Cargacell. Última actualización: 22 de agosto de 2026.