Développeurs

Le mode test et les sandboxes

Les développeurs peuvent construire et tester sur un établissement sandbox avec des clés bk_test_, où rien n'atteint un vrai client et aucun argent réel ne circule.

Ce que c'est

Une sandbox est un établissement de test dans Bookatu, fait pour construire et tester une intégration. Elle répond à la même API avec les mêmes règles de réservation et envoie les mêmes webhooks qu'un établissement réel, mais chaque e-mail, SMS et notification qu'elle enverrait est gardé dans son Outbox, et ses paiements passent par un paiement simulé, sauf si elle est configurée pour le mode test de Stripe. Le guide développeur complet est Testing with a sandbox, sur /developers/testing.

À quoi ça sert

Votre développeur peut essayer chaque appel, acomptes et webhooks compris, sans toucher à votre vrai établissement, à vos clients ou à une vraie carte. Une sandbox affiche Test mode sur chaque page de son admin et « Entreprise de test » sur ses pages de réservation, et elle n'est jamais listée nulle part en public.

Comment l'utiliser

  1. 1Connectez-vous avec un compte Bookatu dont l'e-mail est confirmé et ouvrez /developers/sandbox. Vous n'avez pas besoin d'un établissement sur Bookatu. Choisissez un nom, un fuseau horaire et une monnaie, acceptez les conditions du mode test et créez votre sandbox. Vous pouvez en avoir jusqu'à 3 à la fois. Si la page indique que la création de sandboxes est désactivée pour le moment, elles ne sont pas encore ouvertes.
  2. 2Chaque sandbox est livrée avec une équipe, des prestations, des clients et des réservations d'exemple, et une première clé de test avec tous les périmètres. Les clés de test commencent par bk_test_ et les clés de production par bk_live_. Créez d'autres clés et webhooks dans l'admin de la sandbox, sous Settings, puis API & monitoring.
  3. 3Une clé de test ne fonctionne que sur une sandbox, et une clé de production que sur un établissement réel. L'inverse est refusé avant toute exécution, avec 403 LIVEMODE_MISMATCH, et chaque réponse indique dans livemode quel type d'établissement elle a atteint.
  4. 4Ce que la sandbox aurait envoyé se trouve sous Outbox dans son admin, et chaque paiement simulé qu'elle a fait se trouve sous Test payments, juste à côté : payé, refusé, abandonné ou remboursé. Ses paiements simulés ont des boutons Pay (test), Decline (test) et Abandon au lieu d'un formulaire de carte. Ne saisissez jamais un vrai numéro de carte dans une sandbox. Le simulateur fait arriver des événements tout de suite, comme le paiement d'un acompte.
  5. 5Les paiements peuvent aussi passer par le mode test de Stripe au lieu du simulateur, là où c'est proposé. Sur Test payments, choisissez Connect a Stripe test account et remplissez les pages de Stripe uniquement avec les données de test de Stripe, jamais votre vraie pièce d'identité ni votre vrai compte bancaire. Si vous vous arrêtez en route, Continue on Stripe vous y ramène, et Check again montre si le compte est prêt. Choisissez ensuite Turn on Stripe test mode. Les nouveaux paiements ouvrent la page de paiement de Stripe, où vous payez avec une carte de test comme 4242 4242 4242 4242, et ils sont listés dans Finance. Aucun argent réel ne circule. Revenez aux paiements simulés quand vous voulez.
  6. 6Reset vide une sandbox et la remplit de nouvelles données d'exemple, et Delete la supprime, tous deux depuis votre page des sandboxes. Une sandbox que personne n'utilise pendant 30 jours est supprimée, et vous recevez un e-mail 7 jours avant.
  7. 7Chaque appel, avec des exemples, se trouve dans Testing with a sandbox sur /developers/testing, et en markdown sur /developers/testing.md. Quand tout fonctionne, Going live sur /developers/going-live explique comment passer à la clé d'un établissement réel.

Was this helpful?

Vous n'avez pas trouvé ce qu'il vous faut ?

Contacter le support ou consultez la FAQ.