---
title: "Modo de teste e sandboxes"
description: "Os programadores podem construir e testar num negócio sandbox com chaves bk_test_, onde nada chega a um cliente real nem movimenta dinheiro real."
url: "https://bookatu.com/pt-pt/help/test-mode-and-sandboxes"
language: "pt"
section: "Ajuda"
category: "Programadores"
published: "2026-10-30"
updated: "2026-11-05"
---

# Modo de teste e sandboxes

Os programadores podem construir e testar num negócio sandbox com chaves bk_test_, onde nada chega a um cliente real nem movimenta dinheiro real.

## O que é

Uma sandbox é um negócio de teste dentro do Bookatu, feito para construir e testar uma integração. Responde à mesma API com as mesmas regras de marcação e envia os mesmos webhooks que um negócio real, mas cada email, SMS e notificação que enviaria fica guardado na sua Outbox, e os pagamentos passam por um checkout simulado, a não ser que esteja configurada para o modo de teste do Stripe. O guia completo para programadores é «Testing with a sandbox», em /developers/testing.

## Porque ajuda

O seu programador pode experimentar todas as chamadas, incluindo sinais e webhooks, sem tocar no seu negócio real, nos seus clientes nem num cartão real. Uma sandbox mostra «Test mode» em todas as páginas do admin e «Negócio de teste» nas páginas de marcações, e nunca aparece listada em lado nenhum público.

## Como se usa

1. Inicie sessão com uma conta Bookatu com o email confirmado e abra /developers/sandbox. Não precisa de ter um negócio no Bookatu. Escolha um nome, um fuso horário e uma moeda, aceite os termos do modo de teste e crie a sua sandbox. Pode ter até 3 de cada vez. Se a página disser que a criação de sandboxes está desligada de momento, ainda não estão abertas.
2. Cada sandbox vem com equipa, serviços, clientes e marcações de exemplo, e uma primeira chave de teste com todos os âmbitos. As chaves de teste começam por bk_test_ e as chaves reais começam por bk_live_. Crie mais chaves e webhooks no admin da própria sandbox, em Settings, depois «API & monitoring».
3. Uma chave de teste só funciona numa sandbox, e uma chave real só num negócio real. Ao contrário é recusado antes de correr seja o que for, com 403 LIVEMODE_MISMATCH, e cada resposta indica em livemode que tipo de negócio alcançou.
4. O que a sandbox teria enviado está em Outbox no admin dela, e cada pagamento simulado que fez está em «Test payments», ao lado: pago, recusado, abandonado ou reembolsado. Os checkouts simulados têm os botões «Pay (test)», «Decline (test)» e Abandon em vez de um formulário de cartão. Nunca escreva um número de cartão real numa sandbox. O simulador faz os eventos acontecerem já, como o pagamento de um sinal.
5. Os pagamentos também podem passar pelo modo de teste do Stripe em vez do simulador, onde for oferecido. Em «Test payments», escolha «Connect a Stripe test account» e preencha as páginas do Stripe só com os dados de teste do Stripe, nunca com o seu documento de identificação ou a sua conta bancária reais. Se parar a meio, «Continue on Stripe» leva-o de volta, e «Check again» mostra se a conta está pronta. Depois escolha «Turn on Stripe test mode». Os pagamentos novos abrem a página de checkout do próprio Stripe, onde paga com um cartão de teste como 4242 4242 4242 4242, e aparecem listados em Finance. Não se movimenta dinheiro real. Volte aos pagamentos simulados quando quiser.
6. Reset apaga uma sandbox e enche-a com dados de exemplo novos, e Delete remove-a, ambos a partir da sua página de sandboxes. Uma sandbox que ninguém use durante 30 dias é apagada, e recebe um email 7 dias antes.
7. Todas as chamadas, com exemplos, estão em «Testing with a sandbox», em /developers/testing, e em markdown em /developers/testing.md. Quando tudo funcionar, «Going live», em /developers/going-live, explica como passar para a chave de um negócio real.
