Saltearse al contenido
Cashela Cashela Cashela API

La búsqueda solo está disponible en las versiones de producción. Intenta construir y previsualizar el sitio para probarlo localmente.

Primeros pasos

Tus credenciales de Pay-In las creas tú, en el Portal de Desarrolladores (Developer Portal) de tu panel de Cashela Business. Hay un solo portal para los dos entornos, Sandbox y Producción, y cada entorno tiene sus propias claves API.

Requisitos

  • Una cuenta Cashela Business verificada (verificación de empresa aprobada). Regístrate en cashela.com/business-home.
  • Un servidor con HTTPS que pueda guardar secretos y recibir notificaciones.

El Portal de Desarrolladores

En tu panel de Cashela Business, abre Portal de Desarrolladores desde el menú. Verás una tarjeta por entorno, Sandbox y Producción. Cada tarjeta muestra su estado y sus Claves API. La tarjeta de Sandbox muestra además la Base URL de sandbox con un botón Copiar.

EstadoQué significa
AprovisionandoSe está creando tu sandbox. Suele tardar menos de un minuto.
Falló el aprovisionamientoNo se terminó de crear. Pulsa Reintentar aprovisionamiento; si sigue fallando, contacta con soporte.
ActivoEl entorno está listo para usarse.
En revisión(Producción) Tu solicitud de go-live está en revisión.
Rechazado(Producción) Tu solicitud de go-live fue rechazada. Se muestra el motivo y puedes volver a solicitarlo.
SuspendidoCashela suspendió el entorno. Contacta con soporte.
No habilitado(Producción) Producción aún no está habilitada para tu cuenta. Ver Salir a producción.

Tu sandbox se crea solo

La primera vez que entras al Portal de Desarrolladores, tu sandbox se crea automáticamente. No hay nada que solicitar ni que esperar, aparte del paso de aprovisionamiento.

  • Base URL de sandbox: https://sandbox-api.cashela.com. El portal la muestra con el prefijo de la API (https://sandbox-api.cashela.com/api/v1); las rutas de los endpoints de esta guía ya incluyen /api/v1, así que no lo pongas dos veces.
  • Sandbox no mueve dinero real. Ver Pruebas en sandbox.

Crear una clave API

Los pasos son los mismos en sandbox y, cuando esté habilitada, en producción.

  1. En la tarjeta del entorno, ve a Claves API y pulsa Crear clave.

  2. Escribe un Nombre de la clave que indique dónde se usa (por ejemplo, Integración backend). Añade en Lista blanca de IPs las direcciones IPv4 públicas autorizadas a usar la clave. En producción este campo es obligatorio (al menos una dirección); en sandbox es opcional (ver Lista blanca de IPs más abajo).

  3. Pulsa Crear clave. El portal muestra tu Clave API (API key) y tu Secreto API (API secret).

    El secreto se muestra una sola vez. Cópialo ahora en tu gestor de secretos: no podrás volver a verlo. Marca Ya guardé el secreto en un lugar seguro para cerrar el diálogo.

  4. La clave aparece en la tabla con su Nombre, Clave (los primeros caracteres de la clave, para reconocerla), Estado (Activa o Deshabilitada), Último uso, Creada y Acciones.

Tu clave API es el usuario y tu secreto API es la contraseña de cada petición. Ver Autenticación.

Gestionar tus claves

Cada clave tiene estas acciones:

AcciónQué hace
Deshabilitar / HabilitarUna clave Deshabilitada recibe 401 Unauthorized. en todas las peticiones hasta que la vuelvas a habilitar. Si tus peticiones empiezan a responder 401 de repente, revisa primero el estado.
IPsEdita la lista blanca de IPs de la clave.
RotarEmite una clave y un secreto nuevos. La clave actual sigue funcionando durante un periodo de gracia de 7 días, para que despliegues el secreto nuevo sin cortes. El portal muestra la fecha en que la clave anterior deja de funcionar.
RevocarRevoca la clave de forma permanente. Tienes que escribir el nombre de la clave para confirmar. Toda integración que la siga usando deja de funcionar al instante. No se puede deshacer.

Lista blanca de IPs

  • La lista contiene las direcciones IPv4 públicas de TUS servidores, los que llaman a la API con tu clave (crear depósitos, consultarlos, Pay-Out…). No es una lista de las direcciones de tus clientes: la página de pago que tu cliente abre en su navegador y el retorno a tu sitio funcionan desde cualquier IP y esta lista nunca los restringe.
  • Las claves de producción exigen al menos una dirección IP (o rango CIDR): el portal no crea ni guarda una clave de producción con la lista vacía y rechaza entradas que permitirían cualquier dirección (como 0.0.0.0/0). Las claves creadas antes de esta regla siguen funcionando igual, pero te recomendamos añadir tus IP.
  • En sandbox, una lista vacía significa que cualquier dirección IP puede usar la clave.
  • Con lista, una petición desde cualquier otra dirección se rechaza.
  • Si añades una dirección privada o reservada (como 10.x.x.x, 172.16–31.x.x, 192.168.x.x o 127.x.x.x), el portal te avisa: ninguna petición desde internet puede venir de esas direcciones, así que la clave rechazaría todas las llamadas hasta que añadas una dirección pública. Usa la IP pública del servidor que llama a la API, no la de tu ordenador ni la de la red de tu oficina. Si tu integración no tiene IP fija, contacta a Cashela antes de pedir una clave de producción.

Buenas prácticas

  • Guarda los secretos solo en tus servidores, en un gestor de secretos o en variables de entorno. Nunca en un navegador, una app móvil ni un repositorio de código.
  • Usa una clave por sistema, para poder rotar o revocar una sin afectar a las demás.
  • Rota las claves periódicamente y cada vez que salga alguien con acceso.
  • En producción, la lista blanca con las IP públicas de tus servidores es obligatoria.

Producción

Las credenciales de producción se emiten cuando se aprueba tu solicitud de go-live. Mientras tanto, la tarjeta de Producción muestra el camino:

  1. Integra contra el entorno sandbox.
  2. Completa las verificaciones de Preparación para go-live con actividad real en sandbox.
  3. Solicita el go-live y espera la aprobación de Cashela.

Cuando Producción esté Activo, crea una clave de producción igual que arriba. Base URL de producción: https://production-api.cashela.com. Ver Salir a producción.

Siguientes pasos