---
title: "Modo de prueba y sandboxes"
description: "Los desarrolladores pueden construir y probar contra un negocio sandbox con claves bk_test_, donde nada llega a un cliente real ni mueve dinero real."
url: "https://bookatu.com/es-es/help/test-mode-and-sandboxes"
language: "es"
section: "Ayuda"
category: "Desarrolladores"
published: "2026-10-30"
updated: "2026-11-05"
---

# Modo de prueba y sandboxes

Los desarrolladores pueden construir y probar contra un negocio sandbox con claves bk_test_, donde nada llega a un cliente real ni mueve dinero real.

## Qué es

Un sandbox es un negocio de prueba dentro de Bookatu, pensado para construir y probar una integración. Responde a la misma API con las mismas reglas de reserva y envía los mismos webhooks que un negocio real, pero cada email, SMS y notificación que enviaría se guarda en su Outbox, y sus pagos pasan por un pago simulado salvo que esté configurado para el modo de prueba de Stripe. La guía completa para desarrolladores es Testing with a sandbox, en /developers/testing.

## Por qué ayuda

Tu desarrollador puede probar cada llamada, depósitos y webhooks incluidos, sin tocar tu negocio real, tus clientes ni una tarjeta real. Un sandbox dice Test mode en cada página de su admin y «Negocio de prueba» en sus páginas de reservas, y nunca aparece en ningún sitio público.

## Cómo se usa

1. Inicia sesión con una cuenta de Bookatu con el correo confirmado y abre /developers/sandbox. No necesitas un negocio en Bookatu. Elige un nombre, una zona horaria y una moneda, acepta las condiciones del modo de prueba y crea tu sandbox. Puedes tener hasta 3 a la vez. Si la página dice que crear sandboxes está desactivado en este momento, todavía no están abiertos.
2. Cada sandbox viene con personal, servicios, clientes y reservas de ejemplo, y una primera clave de prueba con todos los permisos. Las claves de prueba empiezan por bk_test_ y las reales por bk_live_. Crea más claves y webhooks en el propio admin del sandbox, en Settings, luego API & monitoring.
3. Una clave de prueba solo funciona en un sandbox, y una clave real solo en un negocio real. Al revés se rechaza antes de ejecutar nada, con 403 LIVEMODE_MISMATCH, y cada respuesta indica en livemode a qué tipo de negocio llegó.
4. Lo que el sandbox habría enviado está en Outbox, en su admin, y cada pago simulado que hizo está en Test payments, al lado: pagado, rechazado, abandonado o devuelto. Sus pagos simulados tienen los botones Pay (test), Decline (test) y Abandon en lugar de un formulario de tarjeta. Nunca escribas un número de tarjeta real en un sandbox. El simulador hace que los eventos pasen ya, como el pago de un depósito.
5. Los pagos también pueden pasar por el modo de prueba de Stripe en lugar del simulador, donde se ofrece. En Test payments, elige Connect a Stripe test account y rellena las páginas de Stripe solo con los datos de prueba de Stripe, nunca con tu documento de identidad ni tu cuenta bancaria reales. Si lo dejas a medias, Continue on Stripe te devuelve allí, y Check again muestra si la cuenta está lista. Después elige Turn on Stripe test mode. Los pagos nuevos abren la propia página de pago de Stripe, donde pagas con una tarjeta de prueba como 4242 4242 4242 4242, y aparecen en Finance. No se mueve dinero real. Vuelve a los pagos simulados cuando quieras.
6. Reset borra un sandbox y lo llena de datos de ejemplo nuevos, y Delete lo elimina, los dos desde tu página de sandboxes. Un sandbox que nadie usa durante 30 días se elimina, y recibes un email 7 días antes.
7. Cada llamada, con ejemplos, está en Testing with a sandbox, en /developers/testing, y en markdown en /developers/testing.md. Cuando funcione, Going live, en /developers/going-live, explica cómo pasar a la clave de un negocio real.
