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.

Flujo de integración

Un depósito sigue siempre la misma secuencia. Los pasos 1 y 2 se pueden guardar en caché brevemente; el paso 2 conviene repetirlo antes de cada depósito, porque las comisiones, la disponibilidad y los campos obligatorios pueden cambiar.

Secuencia de un depósito Pay-In entre tu cliente, tu servidor, la API de Cashela y la página de pago de CashelaTu clienteTu servidorAPI de CashelaPágina de pago de Cashela1. GET /deposit-creation/countriespaíses2. POST /available-payment-methodsmétodos, comisiones, campos3. elige método, datos del pagadordatos del pagador4. POST /deposit-creationPROCESSING + enlace de pago5. redirección al enlace de pago6. pagavuelve a tu redirect_url7. notificación firmada2xx8. GET /transactions/{reference}

Paso a paso

  1. Consulta los países. GET /api/v1/pay-in/deposit-creation/countries devuelve los países disponibles para tu cuenta en el entorno actual. Ver Obtener países.

  2. Consulta los métodos de pago. POST /api/v1/pay-in/deposit-creation/available-payment-methods con country y amount. Cada opción te da el código payment_method, las comisiones, el total que paga tu cliente, lo que se te acredita y los campos del cliente obligatorios para ese método (mandatory_fields, required_fields, document_types). Ver Obtener métodos de pago.

  3. Recoge los datos del cliente. Construye tu formulario con los campos obligatorios de la opción elegida. Ver Datos del pagador y documentos.

  4. Crea el depósito. POST /api/v1/pay-in/deposit-creation con tu external_identifier único y, opcionalmente, la cabecera Idempotency-Key. Ver Crear un depósito.

  5. Envía a tu cliente a pagar. Si la respuesta trae un enlace de pago (data.details.paying.metadata.redirect_url), redirige a tu cliente o ábrelo en una ventana nueva. Si no, muestra las instrucciones de pago. Los pagos con tarjeta siempre usan la página de pago alojada por Cashela; ver Pagos con tarjeta.

  6. Tu cliente paga antes de que venza el enlace (validity_period). Después vuelve a tu redirect_url.

  7. Recibe la notificación. Cuando el depósito llega a un estado final, Cashela envía un POST firmado a tu notification_url. Verifica la firma, actualiza tu pedido y responde 2xx. Ver Webhooks.

  8. Concilia. Consulta el depósito con GET /api/v1/pay-in/transactions/{reference} siempre que necesites confirmar su estado o importes. Ver Consultar un depósito y estados.

Ciclo de vida del depósito

Estados del depósito: ONHOLD, PROCESSING, INREVIEW, y después COMPLETED, DECLINED, CANCELLED o FAILED; un depósito con tarjeta COMPLETED puede pasar a REVERSEDrevisión de documentopagadorechazadocancelado o vencidoanulación / reembolso totalfalló la creaciónONHOLDINREVIEWPROCESSINGCOMPLETEDDECLINEDCANCELLEDREVERSEDFAILEDVerde: dinero acreditado · Rojo: no se movió dinero · Ámbar: dinero devuelto

COMPLETED, DECLINED, CANCELLED, FAILED y REVERSED son finales. Ver la tabla completa de estados.

Lista de control de producción para este flujo

  • Llama a Obtener métodos de pago antes de cada depósito; no fijes códigos de método ni comisiones.
  • Guarda tu external_identifier antes de llamar a Crear un depósito, para que un reintento use el mismo.
  • Verifica la firma de cada notificación y procesa el estado final de cada depósito una sola vez.
  • Trata la vuelta a redirect_url solo como navegación.
  • Concilia dinero solo en COMPLETED (y REVERSED).