Skip to content

Métodos de Pago ​

Configura los métodos de pago disponibles para tus clientes. Accede desde Métodos de pago en el menú lateral del dashboard (visible solo para los roles propietario y administrador).

Configuración de métodos de pago

Categorías de pago ​

Zelta Pay organiza los proveedores de pago en tres tarjetas:

Pagos con Tarjeta ​

Procesa pagos con tarjetas de crédito y débito a través de uno de estos procesadores:

ProveedorCredenciales (Producción y Sandbox)
EmetecAPI Key, Entity ID
NMISecurity Key, Tokenization Key

Solo un procesador de tarjetas puede estar activo a la vez: activar uno desactiva el otro.

Pagos con Yappy ​

Procesa pagos mediante la plataforma Yappy:

ProveedorCredenciales (Producción y Sandbox)
YappyAPI Key, Commerce ID, URL Domain (debe comenzar con https://)

Pagos con PayPal ​

Procesa pagos con cuenta de PayPal o con tarjeta sin cuenta de PayPal:

ProveedorCredenciales (Producción y Sandbox)
PayPalClient ID, Client Secret (de una app REST de PayPal)

Consulta para ver cómo obtener estas credenciales y cómo funciona el pago.

Producción vs. Sandbox ​

Cada proveedor tiene dos bloques de credenciales, Credenciales Producción y Credenciales Sandbox:

  • Sandbox — Entorno de pruebas. Lo usan los links de prueba (creados con Activar entorno sandbox en el dashboard o con isTest: true en la API), así que no mueven dinero real. Te permite verificar tu integración y probar los flujos de pago.
  • Producción — Entorno en vivo. Lo usan los links de producción, que cobran de forma real a tus clientes. Usa estas credenciales solo cuando estés listo para recibir cobros.

Un bloque sin credenciales muestra la etiqueta Faltan.

Configurar un proveedor ​

Agregar credenciales ​

  1. Abre Métodos de pago en el menú lateral
  2. Ubica el proveedor que deseas configurar (Emetec, NMI, Yappy o PayPal)
  3. En el bloque Credenciales Producción o Credenciales Sandbox, haz clic en Agregar Credenciales
  4. En el diálogo Configurar credenciales, ingresa las credenciales proporcionadas por el proveedor
  5. Haz clic en Configurar (por ejemplo, Configurar PayPal)

Antes de guardarlas, Zelta Pay verifica las credenciales con el proveedor. Si el proveedor las rechaza, verás el mensaje Credenciales inválidas y no se guardan. Al guardar credenciales nuevas, el proveedor se activa automáticamente (y, si es un procesador de tarjetas, el otro procesador se desactiva).

Prueba en sandbox primero

Te recomendamos configurar primero las credenciales de sandbox para probar la integración antes de activar el entorno de producción.

Activar o desactivar un proveedor ​

  • Emetec y NMI tienen su propio interruptor junto a la etiqueta Activo / Inactivo. Solo un procesador de tarjetas puede estar activo a la vez.
  • Yappy y PayPal se activan o desactivan con el interruptor del encabezado de su tarjeta (Activado / Desactivado).
  • El interruptor del encabezado de Pagos con Tarjeta sirve para desactivar los pagos con tarjeta; para activarlos, activa Emetec o NMI.

Cada interruptor afecta a ambos entornos (producción y sandbox) del proveedor. No puedes desactivar el último tipo de pago activo: al menos uno debe quedar activo.

Ver credenciales existentes ​

En cada bloque, los valores se muestran enmascarados (••••••••). El botón Credenciales abre un diálogo con los valores completos y botones para copiarlos, así que compártelo solo con quien lo necesite.

Editar credenciales ​

Haz clic en Editar para reemplazar las credenciales de un entorno. Las nuevas credenciales se verifican con el proveedor antes de guardarse.

Eliminar credenciales ​

Haz clic en Eliminar para borrar las credenciales de un entorno. En estos casos no se permite eliminarlas:

  • Son las únicas credenciales del procesador de tarjetas activo: primero activa el otro procesador
  • Son credenciales de Emetec o NMI y hay clientes con su tarjeta guardada en ese procesador (API de Integración)
  • Son credenciales de PayPal y hay pagos de PayPal en confirmación en ese entorno

Cuidado al eliminar credenciales

Sin credenciales, los links de ese entorno ya no pueden pagarse con ese proveedor. Asegúrate de no tener links de pago pendientes que dependan de él antes de eliminar.

Sin proveedor activo no puedes cobrar

Necesitas al menos un proveedor activo con credenciales en el entorno del link: un proveedor configurado solo en sandbox no permite crear links de producción, y viceversa. Sin un proveedor activo, la API devuelve el error ERR_NO_ACTIVE_PAYMENT_PROVIDER y el dashboard no te permite crear links de pago. Tampoco puedes crear la API key ni el webhook de la cuenta hasta tener un proveedor activo.

Siguientes pasos ​

  • — Genera links de cobro directamente desde la interfaz.
  • — Configura PayPal y conoce la experiencia de pago.
  • — Administra webhooks, API keys, miembros y seguridad.
  • — Aprende cómo funcionan los links de pago y sus estados.

Documentación oficial de Zelta