Utviklere

Testmodus og sandboxer

Utviklere kan bygge og teste mot en sandbox-virksomhet med bk_test_-nøkler, der ingenting når en ekte kunde eller flytter ekte penger.

Hva det er

En sandbox er en testvirksomhet inne i Bookatu, laget for å bygge og teste en integrasjon. Den svarer på det samme API-et med de samme bestillingsreglene og sender de samme webhookene som en virksomhet som er live, men hver e-post, SMS og varsling den ville ha sendt, blir lagt i Outbox, og betalingene går gjennom en simulert betaling, med mindre den er satt opp for testmodus i Stripe. Hele utviklerveiledningen er Testing with a sandbox, på /developers/testing.

Hvorfor det hjelper

Utvikleren din kan prøve hvert kall, også depositum og webhooker, uten å røre den ekte virksomheten din, kundene dine eller et ekte kort. En sandbox viser Test mode på hver side i administrasjonen sin og «Testbedrift» på bookingsidene sine, og den blir aldri vist noe offentlig sted.

Slik bruker du det

  1. 1Logg inn med en Bookatu-konto med bekreftet e-post, og åpne /developers/sandbox. Du trenger ingen virksomhet på Bookatu. Velg et navn, en tidssone og en valuta, godta vilkårene for testmodus og lag sandboxen din. Du kan ha opptil 3 om gangen. Står det på siden at det er slått av å lage sandboxer for øyeblikket, er de ikke åpnet ennå.
  2. 2Hver sandbox kommer med eksempler på ansatte, tjenester, kunder og bestillinger, og en første testnøkkel med alle tilgangsområder. Testnøkler starter med bk_test_ og livenøkler med bk_live_. Lag flere nøkler og webhooker i sandboxens egen administrasjon, under Settings, så API & monitoring.
  3. 3En testnøkkel virker bare på en sandbox, og en livenøkkel bare på en virksomhet som er live. Motsatt vei blir avvist før noe kjøres, med 403 LIVEMODE_MISMATCH, og hvert svar oppgir i livemode hvilken type virksomhet det nådde.
  4. 4Det sandboxen ville ha sendt, ligger under Outbox i administrasjonen, og hver simulert betaling den har gjort, ligger under Test payments, ved siden av: betalt, avvist, avbrutt eller refundert. De simulerte betalingssidene har knappene Pay (test), Decline (test) og Abandon i stedet for et kortskjema. Skriv aldri inn et ekte kortnummer i en sandbox. Simulatoren får hendelser til å skje nå, for eksempel at et depositum blir betalt.
  5. 5Betalinger kan også gå gjennom testmodus i Stripe i stedet for simulatoren, der det tilbys. På Test payments velger du Connect a Stripe test account og fyller ut sidene til Stripe med bare testopplysningene til Stripe, aldri din ekte legitimasjon eller bankkonto. Stopper du halvveis, tar Continue on Stripe deg tilbake, og Check again viser om kontoen er klar. Velg så Turn on Stripe test mode. Nye betalinger åpner Stripes egen betalingsside, der du betaler med et testkort som 4242 4242 4242 4242, og de vises under Finance. Ingen ekte penger flyttes. Bytt tilbake til simulerte betalinger når du vil.
  6. 6Reset sletter alt i en sandbox og fyller den med nye eksempeldata, og Delete fjerner den, begge fra sandbox-siden din. En sandbox som ingen bruker på 30 dager, blir slettet, og du får en e-post 7 dager før.
  7. 7Hvert kall, med eksempler, står i Testing with a sandbox på /developers/testing, og som markdown på /developers/testing.md. Når det virker, forteller Going live på /developers/going-live hvordan du bytter til nøkkelen til en virksomhet som er live.

Was this helpful?

Fant du ikke det du lette etter?

Kontakt kundestøtte eller se vanlige spørsmål.