Inicio rápido

La API de Cashela permite a tu empresa cobrar pagos (Pay-In) y enviar pagos (Pay-Out) con una sola API REST, en JSON sobre HTTPS. Los dos productos usan las mismas credenciales y la misma autenticación.

Empieza

1. Abre una cuenta Cashela Business. Regístrate en cashela.com/business-home y completa la verificación de empresa.

2. Crea tu clave API de sandbox. En tu panel, abre el Portal de Desarrolladores. Tu sandbox se crea automáticamente. Crea una clave y guarda su secreto API: se muestra una sola vez. Ver Primeros pasos.

3. Haz tu primera llamada. Todas las peticiones usan autenticación HTTP Basic: tu api_key es el usuario y tu api_secret la contraseña.

   curl https://sandbox-api.cashela.com/api/v1/pay-in/deposit-creation/countries \
     -u "$CASHELA_API_KEY:$CASHELA_API_SECRET" \
     -H "Accept: application/json"

4. Construye y prueba en sandbox. Sandbox no mueve dinero real. Sigue el flujo de integración de Pay-In o la descripción de Pay-Out, verifica tus webhooks y gestiona los errores.

5. Sal a producción. Cuando las verificaciones de preparación estén en verde, solicita el acceso a producción en el Portal de Desarrolladores. Tras la aprobación, crea una clave de producción y cambia la URL base. Ver Salir a producción.

Entornos

Entorno	URL base	Credenciales
Sandbox	https://sandbox-api.cashela.com	Claves de la tarjeta Sandbox del Portal de Desarrolladores
Producción	https://production-api.cashela.com	Claves de la tarjeta Producción, tras aprobarse tu solicitud de go-live

Precaución

Las credenciales de sandbox y de producción son distintas: una clave solo funciona en su propio entorno. Guarda tu api_secret solo en tus servidores; además firma los webhooks que te envía Cashela.

Productos

Producto	Qué hace	Empieza aquí
API Pay-In	Cobra a tus clientes con métodos locales (transferencia bancaria, voucher en efectivo, dinero móvil) y tarjetas, en un checkout alojado por Cashela.	Descripción de Pay-In
API Pay-Out	Envía dinero a destinatarios en el exterior.	Descripción de Pay-Out

Monedero, tarjetas de regalo, pago de facturas y recargas móviles llegarán pronto.

Convenciones

• Códigos de país: ISO 3166-1 alfa-3 (MEX, CHL, BRA).
• Códigos de moneda: ISO 4217 (USD, MXN).
• Nombres de campo: snake_case.
• Envía tu propia cabecera X-Trace-Id en cada petición y cítala a soporte.

¿Necesitas ayuda?

Contacta con el soporte de Cashela indicando el X-Trace-Id de la petición y la referencia de la transacción.