Testmodus en sandboxes
Ontwikkelaars kunnen bouwen en testen tegen een sandboxbedrijf met bk_test_-sleutels, waar niets een echte klant bereikt en er geen echt geld beweegt.
Wat het is
Een sandbox is een testbedrijf binnen Bookatu, gemaakt om een koppeling te bouwen en te testen. Hij beantwoordt dezelfde API met dezelfde boekingsregels en stuurt dezelfde webhooks als een live bedrijf, maar elke e-mail, sms en melding die hij zou sturen, wordt bewaard in zijn Outbox, en zijn betalingen gaan via een gesimuleerde checkout, tenzij hij is ingesteld voor de testmodus van Stripe. De volledige gids voor ontwikkelaars is Testing with a sandbox, op /developers/testing.
Waarom het helpt
Je ontwikkelaar kan elke aanroep proberen, aanbetalingen en webhooks inbegrepen, zonder je echte bedrijf, je klanten of een echte kaart aan te raken. Een sandbox toont Test mode op elke pagina van zijn admin en Testbedrijf op zijn boekingspagina's, en hij staat nooit ergens openbaar vermeld.
Zo gebruik je het
- 1Log in met een Bookatu-account met een bevestigd e-mailadres en open /developers/sandbox. Je hebt geen bedrijf op Bookatu nodig. Kies een naam, een tijdzone en een valuta, accepteer de voorwaarden voor de testmodus en maak je sandbox. Je kunt er tot 3 tegelijk hebben. Staat er op de pagina dat het maken van sandboxes op dit moment uitstaat, dan zijn ze nog niet open.
- 2Elke sandbox komt met voorbeeldmedewerkers, diensten, klanten en boekingen, en een eerste testsleutel met elke scope. Testsleutels beginnen met bk_test_ en live sleutels met bk_live_. Maak meer sleutels en webhooks in de eigen admin van de sandbox, onder Settings, daarna API & monitoring.
- 3Een testsleutel werkt alleen op een sandbox, en een live sleutel alleen op een live bedrijf. Andersom wordt geweigerd voordat er iets draait, met 403 LIVEMODE_MISMATCH, en elk antwoord zegt in livemode bij wat voor bedrijf het uitkwam.
- 4Wat de sandbox zou hebben verstuurd, staat onder Outbox in zijn admin, en elke gesimuleerde betaling die hij deed, staat ernaast onder Test payments: betaald, geweigerd, afgebroken of terugbetaald. Zijn gesimuleerde checkouts hebben de knoppen Pay (test), Decline (test) en Abandon in plaats van een kaartformulier. Typ nooit een echt kaartnummer in een sandbox. De simulator laat gebeurtenissen nu plaatsvinden, zoals een aanbetaling die betaald wordt.
- 5Betalingen kunnen ook via de testmodus van Stripe gaan in plaats van via de simulator, waar dat wordt aangeboden. Kies op Test payments voor Connect a Stripe test account en vul de pagina's van Stripe alleen in met de testgegevens van Stripe, nooit met je echte identiteitsbewijs of bankrekening. Stop je halverwege, dan brengt Continue on Stripe je terug, en Check again laat zien of het account klaar is. Kies daarna Turn on Stripe test mode. Nieuwe betalingen openen de eigen checkoutpagina van Stripe, waar je betaalt met een testkaart zoals 4242 4242 4242 4242, en ze staan in Finance. Er beweegt geen echt geld. Ga terug naar gesimuleerde betalingen wanneer je wilt.
- 6Reset wist een sandbox en vult hem met verse voorbeeldgegevens, en Delete verwijdert hem, allebei vanaf je sandboxpagina. Een sandbox die 30 dagen door niemand wordt gebruikt, wordt verwijderd, en je krijgt 7 dagen van tevoren een e-mail.
- 7Elke aanroep, met voorbeelden, staat in Testing with a sandbox op /developers/testing, en als markdown op /developers/testing.md. Werkt het, dan zegt Going live op /developers/going-live hoe je overstapt op de sleutel van een live bedrijf.
Gerelateerde handleidingen
Was this helpful?
Niet gevonden wat je zocht?
Contact met support of bekijk de FAQ.