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
- 1Inicie 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.
- 2Cada 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».
- 3Uma 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.
- 4O 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.
- 5Os 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.
- 6Reset 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.
- 7Todas 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.
Guias relacionados
Was this helpful?
Não encontrou o que precisava?
Contactar o suporte ou consulte as perguntas frequentes.