Kehittäjille

Testitila ja sandboxit

Kehittäjät voivat rakentaa ja testata sandbox-yritystä vasten bk_test_-avaimilla, eikä mikään tavoita oikeaa asiakasta tai liikuta oikeaa rahaa.

Mikä se on

Sandbox on testiyritys Bookatun sisällä, tehty integraation rakentamiseen ja testaamiseen. Siinä toimii sama API samoilla varaussäännöillä, ja se lähettää samat webhookit kuin oikea yritys, mutta jokainen sähköposti, tekstiviesti ja ilmoitus, jonka se lähettäisi, pidetään sen Outboxissa, ja sen maksut kulkevat simuloidun maksusivun kautta, ellei sitä ole asetettu Stripen testitilaan. Koko kehittäjäopas on Testing with a sandbox osoitteessa /developers/testing.

Miksi siitä on hyötyä

Kehittäjäsi voi kokeilla jokaista kutsua, myös ennakkomaksuja ja webhookeja, koskematta oikeaan yritykseesi, asiakkaisiisi tai oikeaan korttiin. Sandboxin hallinnan jokaisella sivulla lukee Test mode ja sen varaussivuilla ”Testiyritys”, eikä sitä koskaan listata missään julkisesti.

Näin käytät sitä

  1. 1Kirjaudu Bookatu-tilillä, jonka sähköposti on vahvistettu, ja avaa /developers/sandbox. Et tarvitse yritystä Bookatussa. Valitse nimi, aikavyöhyke ja valuutta, hyväksy testitilan ehdot ja luo sandboxisi. Sinulla voi olla enintään 3 kerrallaan. Jos sivulla lukee, että sandboxien luominen on tällä hetkellä pois käytöstä, ne eivät ole vielä avoinna.
  2. 2Jokaisessa sandboxissa on valmiina esimerkkityöntekijöitä, -palveluita, -asiakkaita ja -varauksia sekä ensimmäinen testiavain kaikilla oikeusalueilla. Testiavaimet alkavat bk_test_ ja live-avaimet bk_live_. Tee lisää avaimia ja webhookeja sandboxin omassa hallinnassa kohdassa Settings, sitten API & monitoring.
  3. 3Testiavain toimii vain sandboxissa ja live-avain vain oikeassa yrityksessä. Toisin päin pyyntö hylätään ennen kuin mitään ajetaan, virheellä 403 LIVEMODE_MISMATCH, ja jokainen vastaus kertoo kentässä livemode, millaiseen yritykseen se osui.
  4. 4Se, minkä sandbox olisi lähettänyt, on sen hallinnassa kohdassa Outbox, ja jokainen sen tekemä simuloitu maksu on sen vieressä kohdassa Test payments: maksettu, hylätty, keskeytetty tai hyvitetty. Sen simuloiduilla maksusivuilla on korttilomakkeen sijaan painikkeet Pay (test), Decline (test) ja Abandon. Älä koskaan kirjoita oikeaa kortinnumeroa sandboxiin. Simulaattori saa tapahtumat tapahtumaan heti, esimerkiksi ennakkomaksun maksamisen.
  5. 5Maksut voivat myös kulkea simulaattorin sijaan Stripen testitilan kautta, kun se on tarjolla. Valitse Test payments -sivulla Connect a Stripe test account ja täytä Stripen sivut vain Stripen testitiedoilla, ei koskaan oikealla henkilöllisyydelläsi tai pankkitililläsi. Jos keskeytät kesken, Continue on Stripe vie sinut takaisin, ja Check again näyttää, onko tili valmis. Valitse sitten Turn on Stripe test mode. Uudet maksut avaavat Stripen oman maksusivun, jolla maksat testikortilla, esimerkiksi 4242 4242 4242 4242, ja ne listataan kohdassa Finance. Oikeaa rahaa ei liiku. Vaihda takaisin simuloituihin maksuihin milloin haluat.
  6. 6Reset tyhjentää sandboxin ja täyttää sen uusilla esimerkkitiedoilla, ja Delete poistaa sen, molemmat sandbox-sivultasi. Sandbox, jota kukaan ei käytä 30 päivään, poistetaan, ja saat sähköpostin 7 päivää ennen.
  7. 7Jokainen kutsu esimerkkeineen on oppaassa Testing with a sandbox osoitteessa /developers/testing ja markdownina osoitteessa /developers/testing.md. Kun kaikki toimii, Going live osoitteessa /developers/going-live kertoo, miten vaihdat oikean yrityksen avaimeen.

Was this helpful?

Etkö löytänyt etsimääsi?

Ota yhteyttä tukeen tai selaa usein kysyttyjä.