Ir al contenido principal

¿Cómo configurar Orchestra Payments en Kunas?

Conoce el paso a paso para integrar Orchestra a Kunas y empezar a recibir los pagos de tus reservas directas.

Escrito por Experto Kunas

Debes contar con una cuenta activa en Orchestra y en la pasarela que quieras utilizar. La disponibilidad de cada una depende del país de la cuenta, la moneda y las validaciones regulatorias de cada proveedor. Si aún no conoces ¿Qué es Orchestra y cuáles son las pasarelas de pago disponibles? te invitamos a revisar el contenido de la guía ¿Qué es Orchestra Payments?

La configuración completa te entrega 3 valores que vas a pegar en Kunas al final:

  1. Nombre de la cuenta de pasarela: La creas en el Paso 2

  2. API Key: La generas en el Paso 4

  3. Entorno: Prueba (Test) o Producción (Live)

Antes de empezar necesitas: una cuenta activa y aprobada en tu pasarela de pago (si aún no tienes una, el Paso 2 incluye una opción de prueba), y acceso a tu panel de Kunas PMS.

Paso 1: Crea tu cuenta en Orchestra

Ingresa a portal.orchestrasolutions.com/#/register. Ingresa tu nombre, un usuario y tu correo. Deja marcada la opción "Is Sandbox" (ℹ️ Una cuenta sandbox es para pruebas — no se mueve dinero real. En el Paso 8 vas a pasar a una cuenta de producción).

Haz clic en el enlace de confirmación que llega a tu correo, define una contraseña (8-16 caracteres) y haz clic en Activate User.

Paso 2: Conecta tu pasarela de pago

En el portal de Orchestra, ve a Payment Gateway Accounts → Create y completa:

  • Name: El nombre que tú elijas, ej. miHotelStripe (3-64 letras/números, sin espacios).

  • Payment Gateway Name: Selecciona tu proveedor de la lista.

  • Credenciales: Las que te entrega el panel de tu proveedor. Cada uno pide credenciales distintas (Stripe: clave secreta sk_test_… para pruebas; PayU/Bold/dLocal: usualmente usuario, contraseña y llaves de comercio).

  • Haz clic en Save.

✅ Valor N° 1 — Name Payment Gateway Account

Guarda el Name que elegiste (ej. miHotelStripe).

Paso 3: Crea tu wallet de tarjetas

Ve a Resources → eWallet Accounts → Add Account y completa:

  • Name — ej. pagos-tarjeta

  • eWallet Type — CardPay

  • Merchant Identifier — un ID único en formato dominio invertido, ej. com.tuhotel.pagos

  • Merchant Display Name — el nombre de tu propiedad (el huésped lo ve en el formulario de pago)

  • Marca "Perform 3Ds?" y "I Have 3DS Merchant Details"

  • Ingresa tu Merchant Requestor Id Suffix

  • Ingresa tu Merchant Url (tu sitio web)

  • Agrega una fila por cada marca de tarjeta con Bin, Brand, MCC y Merchant Id.

Para obtener tus datos de comercio 3DS (3D Secure): BIN, MID y MCC. Debes comunicarte con el equipo de soporte técnico o comercial de tu pasarela de pagos o de tu banco adquirente en Colombia.

⚠️ Nunca actives "Perform 3Ds?" sin completar las filas de datos de comercio — todos los pagos con 3-D Secure fallarían. Tu proveedor de pagos también debe soportar 3-D Secure.

✅3-D Secure (recomendado — obligatorio para tarjetas de la UE/Reino Unido)

✅ Valor N° 2 — Name eWallet Account

Guarda el Name de este wallet (ej. pagos-tarjeta).

Paso 4: Genera tu API Key

  1. Ve a API Keys en el portal de Orchestra y crea una nueva llave.

  2. Nómbrala Kunas.

  3. Haz clic en Save y copia la llave del pop-up.

✅ Valor N° 3 — Name API Key.

Se muestra una sola vez. Trátala como una contraseña — no la compartas en ningún medio. Si la pierdes, crea una nueva.

Paso 5: Conecta Orchestra en Kunas

  1. Ingresa a Kunas PMS.

  2. Ve a Configuración > Integraciones.

  3. Activa Orchestra Payments.

  4. Ingresa:

    • API Key — Valor N° 3

    • Nombre de la cuenta de pasarela — Valor N° 1 (ej. miHotelStripe)

    • Nombre del wallet de tarjetas — Valor N° 2 (ej. pagos-tarjeta)

  5. (Opcional) Marca Aplicar valores a todas las propiedades.

  6. Haz clic en Guardar y luego en Test Connection.

⚠️ Los nombres deben coincidir exactamente con los de Orchestra — cópialos y pégalos para evitar errores de tipeo.

Paso 6: Selecciona Orchestra como pasarela de pagos

  1. Ve a Configuración > Políticas en Kunas PMS y activa el interruptor de "Pago requerido".

  2. Selecciona Orchestra Payments como pasarela.

Paso 7: Haz una reserva de prueba

Abre tu motor de reserva y realiza una reserva, paga con una tarjeta de prueba. Con testSuccess, cualquier dato de tarjeta funciona. Con un proveedor real en modo de prueba, cada uno tiene sus propias tarjetas de prueba (revisa la documentación de tu proveedor).

Verifica que el pago aparezca en tu Portal de Orchestra y que la reserva quede confirmada en Kunas.

Importante: Si estas en modo prueba

Si estas en modo sanbox o prueba, contacta a Orchestra para pasar a una cuenta de producción. Crea una nueva Payment Gateway Account con las credenciales live de tu proveedor (ej. miHotelStripeLive), crea una nueva API Key para producción.

En Kunas, actualiza la API Key y el Nombre de la cuenta de pasarela, y cambia el Entorno a Live. Haz una reserva real pequeña con una tarjeta real y luego reembólsala.

Opcional: Agregar Google Play, Apple Pay o PayPal

Google Pay

  1. En Google Pay & Wallet Console, crea un perfil de negocio, registra tu sitio web y espera la aprobación de Google.

  2. Copia tu Merchant ID.

  3. En Orchestra, ve a Resources → eWallet Accounts → Add Account: Name google-pay, Type GooglePay, Merchant Identifier = tu Google Merchant ID, más tu nombre a mostrar.

  4. En Kunas, pega google-pay en Google Pay Wallet Name.

ℹ️ Puedes probar antes de la aprobación de Google; los pagos reales requieren aprobación y un proveedor compatible con 3-D Secure. El botón solo aparece en dispositivos compatibles (Chrome, Android).

Apple Pay

Requiere membresía en el Apple Developer Program (USD 99/año).

  1. En el portal de Apple Developer, crea un Merchant ID (ej. merchant.com.tuhotel).

  2. Verifica el dominio donde corre tu Booking Engine. Apple entrega un archivo de verificación que debe alojarse en ese dominio — contacta a soporte de Kunas y lo alojamos por ti.

  3. Crea los certificados de Payment Processing y Merchant Identity, conviértelos a formato PEM.

  4. En Orchestra, agrega un wallet: Name apple-pay, Type ApplePay, con tu Merchant ID, nombre a mostrar, dominio y los cuatro valores PEM.

  5. En Kunas, pega apple-pay en Apple Pay Wallet Name.

ℹ️ El botón solo aparece en Safari, en dispositivos Apple.

PayPal

  1. Con una cuenta PayPal Business, ingresa al PayPal Developer Dashboard.

  2. En Apps & Credentials, crea una app Merchant (Sandbox para pruebas, Live para producción).

  3. Copia el Client ID y el Secret.

  4. En Orchestra, agrega un wallet: Name paypal, Type PayPal, Merchant Identifier = Client ID, Secret = Secret.

  5. En Kunas, pega paypal en PayPal Wallet Name.

Solución de problemas

  • "Test Connection" falla — la API Key está mal pegada o fue revocada. Crea una nueva llave y pégala de nuevo.

  • Advertencia de entorno no coincide — una cuenta sandbox solo funciona con Test; una cuenta de producción solo con Live.

  • Los botones de pago no aparecen — los nombres de wallet en Kunas deben coincidir exactamente con los de Orchestra.

  • Todos los pagos con 3-D Secure fallan — "Perform 3Ds?" está activo pero faltan los datos de comercio. Completa el Paso 3 o desactívalo.

  • Pagos rechazados — revisa las credenciales de tu proveedor en Orchestra, y no uses tarjetas reales en Test ni tarjetas de prueba en Live.

  • No aparece el botón de Google Pay / Apple Pay — es normal: solo se muestran en navegadores y dispositivos compatibles.

¿Necesitas ayuda?

Cuenta o portal de Orchestra: contacta directamente a soporte de Orchestra o consulta developers.orchestrasolutions.com. Tu Booking Engine o la conexión con Kunas: escríbenos por el chat de soporte de Kunas.

KUNAS - All rights reserved ©

www.kunas.io - www.app.kunas.io

Artículos relacionados
¿Ha quedado contestada tu pregunta?