Testtilstand og sandboxes
Udviklere kan bygge og teste mod en sandbox-virksomhed med bk_test_-nøgler, hvor intet når en rigtig kunde eller flytter rigtige penge.
Hvad det er
En sandbox er en testvirksomhed inde i Bookatu, lavet til at bygge og teste en integration. Den svarer på det samme API med de samme bookingregler og sender de samme webhooks som en live virksomhed, men hver e-mail, sms og notifikation, den ville sende, bliver holdt i dens Outbox, og dens betalinger går gennem en simuleret betaling, medmindre den er sat op til Stripes testtilstand. Den fulde udviklerguide er Testing with a sandbox, på /developers/testing.
Hvorfor det hjælper
Din udvikler kan prøve hvert kald, depositum og webhooks inklusive, uden at røre din rigtige virksomhed, dine kunder eller et rigtigt kort. En sandbox viser Test mode på hver side i sin administration og ”Testvirksomhed” på sine bookingsider, og den bliver aldrig vist noget offentligt sted.
Sådan bruger du det
- 1Log ind med en Bookatu-konto, hvis e-mail er bekræftet, og åbn /developers/sandbox. Du behøver ikke en virksomhed på Bookatu. Vælg et navn, en tidszone og en valuta, acceptér vilkårene for testtilstand, og lav din sandbox. Du kan have op til 3 ad gangen. Hvis siden siger, at det er slået fra at lave sandboxes lige nu, er de ikke åbnet endnu.
- 2Hver sandbox kommer med eksempler på medarbejdere, ydelser, kunder og bookinger og en første testnøgle med alle scopes. Testnøgler starter med bk_test_, og live-nøgler starter med bk_live_. Lav flere nøgler og webhooks i sandboxens egen administration under Settings og derefter API & monitoring.
- 3En testnøgle virker kun på en sandbox, og en live-nøgle kun på en live virksomhed. Den omvendte vej bliver afvist, før noget kører, med 403 LIVEMODE_MISMATCH, og hvert svar fortæller i livemode, hvilken slags virksomhed det nåede.
- 4Det, sandboxen ville have sendt, står under Outbox i dens administration, og hver simuleret betaling, den har lavet, står under Test payments ved siden af: betalt, afvist, opgivet eller refunderet. Dens simulerede betalinger har knapperne Pay (test), Decline (test) og Abandon i stedet for en kortformular. Skriv aldrig et rigtigt kortnummer i en sandbox. Simulatoren får hændelser til at ske nu, for eksempel at et depositum bliver betalt.
- 5Betalinger kan også gå gennem Stripes testtilstand i stedet for simulatoren, hvor det bliver tilbudt. På Test payments vælger du Connect a Stripe test account og udfylder Stripes sider kun med Stripes testoplysninger, aldrig dit rigtige ID eller din rigtige bankkonto. Stopper du halvvejs, fører Continue on Stripe dig tilbage, og Check again viser, om kontoen er klar. Vælg så Turn on Stripe test mode. Nye betalinger åbner Stripes egen betalingsside, hvor du betaler med et testkort som 4242 4242 4242 4242, og de bliver vist i Finance. Ingen rigtige penge flytter sig. Skift tilbage til simulerede betalinger, når du vil.
- 6Reset tømmer en sandbox og fylder den med nye eksempeldata, og Delete fjerner den, begge fra din side med sandboxes. En sandbox, som ingen bruger i 30 dage, bliver slettet, og du får en e-mail 7 dage før.
- 7Hvert kald, med eksempler, står i Testing with a sandbox på /developers/testing og som markdown på /developers/testing.md. Når det virker, forklarer Going live på /developers/going-live, hvordan du skifter til en live virksomheds nøgle.
Beslægtede guides
Was this helpful?
Fandt du ikke det, du søgte?
Kontakt support eller gå til ofte stillede spørgsmål.