Pagos e impuestos · para Anfitriones

Conectar pagos con Revolut (incluidos sandbox y tarjetas de prueba)

Conecta tu cuenta de comerciante de Revolut Business: claves y tarjetas de prueba sandbox, webhook, métodos de pago, fianzas y paso a modo real.

Los huéspedes pagan la tasa turística, la fianza y los extras a través de tu propia cuenta de comerciante de Revolut Business. El dinero va directamente a ti; nosotros nunca lo retenemos. Necesitas una cuenta de Revolut Business con el producto Merchant (aceptación de tarjetas) activado.

Te recomendamos encarecidamente conectar primero el sandbox. El sandbox es una copia de prueba independiente de Revolut Business: no se mueve dinero real y puedes probar todos los resultados posibles con tarjetas de prueba.

1. Crea una cuenta sandbox de Revolut #

1. Ve a https://sandbox-business.revolut.com/signup y regístrate.
2. Si no sabes qué forma jurídica elegir, selecciona Public Limited Company (las cuentas de autónomo no se admiten en el sandbox).
3. Cuando se te pida verificar tu correo electrónico, haz clic en Skip email verification. Para el código de confirmación, haz clic en Autofill code. Las aprobaciones en el sandbox son automáticas.

2. Copia las claves de API del sandbox #

1. Inicia sesión en https://sandbox-business.revolut.com/signin.
2. Abre Merchant, haz clic en el menú ⋯ y elige Merchant API (enlace directo: https://sandbox-business.revolut.com/settings/apis?tab=merchant-api).
3. Haz clic en Generate junto a Secret key si todavía no existe ninguna y cópiala (empieza por sk_).
4. Copia también la Public key (empieza por pk_). Se necesita para los botones de Apple Pay y Google Pay.

3. Introduce las claves en tu panel #

1. Abre Settings → Payments (Ajustes → Pagos).
2. Pega la Secret API key y la Public API key.
3. Marca Sandbox mode (test payments with Revolut test cards).
4. Haz clic en Save y luego en Test connection. Deberías ver Connected to Revolut (sandbox).
5. Haz clic en Register webhook. A partir de ahora, Revolut avisa al instante a tu portal cuando un pago se completa o falla, o cuando se cobra o se libera una retención de fianza. El estado cambia a Registered.

La clave secreta se guarda cifrada. Cuando vuelvas más tarde, se mostrará enmascarada; déjala como está para conservar la clave guardada.

4. Prueba con las tarjetas de prueba de Revolut #

Crea una reserva de prueba con tu propio correo electrónico, abre el enlace del huésped y paga. En el sandbox, usa cualquier fecha de caducidad futura y cualquier CVV de 3 dígitos.

Los importes inferiores a 30,00 € (o 25,00 £) están exentos de 3-D Secure en el sandbox y se completan sin verificación. Para ver un fallo de 3-D Secure, usa una reserva de prueba con una fianza de al menos 30 €.

Comprueba en el panel que:

• la tasa turística aparece como Paid y la fianza como Held (preautorización) o Paid (modo cobro),
• el portal del huésped se desbloquea cuando se completan todos los pasos,
• llega un recibo por correo electrónico,
• Release deposit en la reserva reembolsa el importe o libera la retención.

Prueba desde Settings → Payments #

No necesitas una reserva para probar toda la cadena. En Settings → Payments → Test payments, introduce un importe (1–50) y pulsa:

• Test charge & refund: paga el pedido de prueba en la nueva pestaña y luego pulsa Refund. Así funcionan las tasas, los extras y las fianzas en modo cobro y reembolso.
• Test deposit hold & release: paga el pedido de prueba (el importe solo se retiene en la tarjeta) y luego pulsa Release hold, o Keep half, release rest y después Refund the kept part. Este es el modo de fianza retención.

Cada prueba muestra lo que respondió Revolut en cada paso y marca Webhook received cuando la notificación firmada de Revolut ha llegado a Guestbud: eso es lo que confirma los pagos de los huéspedes por sí solo. Si el webhook nunca llega, pulsa Register webhook. En modo real, la prueba usa una tarjeta real y se reembolsa de inmediato; Revolut puede quedarse con su comisión.

5. Pasa a modo real #

1. En tu cuenta real de Revolut Business (https://business.revolut.com), abre Merchant → ⋯ → Merchant API y copia las claves secreta y pública reales.
2. En Settings → Payments, pégalas, desmarca Sandbox mode, pulsa Save y Test connection (live).
3. Vuelve a hacer clic en Register webhook: la cuenta real necesita su propio webhook.
4. Haz un pequeño pago real con tu propia tarjeta y reembólsalo en Revolut.

Métodos de pago #

En Payment methods, elige qué se ofrece a los huéspedes:

• Card payment (pago con tarjeta): checkout alojado por Revolut (todas las tarjetas principales, 3-D Secure).
• Apple Pay y Google Pay: consulta Apple Pay y Google Pay.
• Manual payment (pago manual): desactivado por defecto. Actívalo para que los huéspedes puedan elegir efectivo o transferencia bancaria; tú lo confirmas con Mark as paid en la reserva. Añade instrucciones, como tu IBAN.

Fianzas: retención o cobro #

Una fianza puede ser una preautorización en la tarjeta (el dinero se reserva pero no se cobra; se libera tras el check-out) o un cobro que reembolsas después. Las retenciones caducan por defecto a los 7 días; marca Deposits as card pre-authorisation for up to 30 days si tu cuenta de Revolut tiene autorizaciones ampliadas. Más detalles: Fianzas y exoneraciones.

Solución de problemas #

¿Test connection indica que Revolut ha rechazado la clave (401)? #

Probablemente has pegado una clave real en modo sandbox o al revés, o has copiado la clave pública en el campo de la secreta. La clave secreta empieza por sk_.

¿El huésped ha pagado, pero la reserva sigue indicando que espera al banco? #

Falta el webhook o apunta a una dirección antigua. Vuelve a hacer clic en Register webhook. Además, el portal vuelve a comprobar los pagos pendientes cada vez que el huésped abre la página.

¿Puedo usar una sola cuenta de Revolut para varias empresas? #

Cada cliente conecta su propia cuenta de comerciante. Si gestionas propiedades de varios propietarios bajo una misma empresa, basta con una cuenta.

¿Guarda el portal del huésped los datos de las tarjetas? #

No. Los datos de la tarjeta se introducen en las páginas de Revolut o en la ventana de pago de Revolut y nunca llegan a nuestros servidores.

Modo de fianza, plazo de liberación y seguridad del sandbox #

En Settings → Payments → Revolut Merchant:

• Deposit mode (modo de fianza): Charge & refund (el predeterminado): la fianza se cobra por adelantado y se reembolsa tras el check-out, total o parcialmente; es seguro para cualquier duración de la estancia. Hold (pre-authorisation): el importe solo se bloquea en la tarjeta y se libera automáticamente, pero una retención dura como máximo 7 días (30 con preautorización), así que solo es adecuada para estancias cortas. Todas las propiedades siguen este valor predeterminado salvo que su Guide editor → Payments → How it is taken indique otra cosa; marca Use this deposit mode for all properties para cambiarlas todas al valor predeterminado.
• Release the hold this many days after check-out (liberar la retención tantos días después del check-out; 2 por defecto): tu margen para revisar la propiedad y retener dinero por daños antes de que Revolut libere la retención por sí solo. 0 = liberar en el check-out.
• Sandbox test email (correo de prueba del sandbox): mientras Sandbox mode está activado, nunca se contacta con huéspedes reales: los correos para huéspedes van a esta dirección (vacío = el correo del anfitrión) y los mensajes a través del canal de la reserva se retienen. Desactiva el sandbox solo cuando estés listo para aceptar pagos reales con una clave real.