Modalità di prova e sandbox
Gli sviluppatori possono costruire e fare test su un'attività sandbox con chiavi bk_test_, dove nulla arriva a un cliente reale e non si muovono soldi veri.
Cos'è
Una sandbox è un'attività di prova dentro Bookatu, fatta per costruire e testare un'integrazione. Risponde alla stessa API con le stesse regole di prenotazione e invia gli stessi webhook di un'attività reale, ma ogni email, SMS e notifica che invierebbe viene tenuta nel suo Outbox, e i suoi pagamenti passano da un pagamento simulato, a meno che non sia impostata per la modalità di test di Stripe. La guida completa per sviluppatori è Testing with a sandbox, su /developers/testing.
Perché ti aiuta
Il tuo sviluppatore può provare ogni chiamata, compresi acconti e webhook, senza toccare la tua attività reale, i tuoi clienti o una carta vera. Una sandbox mostra Test mode su ogni pagina della sua area di gestione e 'Attività di prova' sulle sue pagine di prenotazione, e non è mai elencata da nessuna parte in pubblico.
Come si usa
- 1Accedi con un account Bookatu con l'email confermata e apri /developers/sandbox. Non ti serve un'attività su Bookatu. Scegli un nome, un fuso orario e una valuta, accetta le condizioni della modalità di prova e crea la tua sandbox. Puoi averne fino a 3 alla volta. Se la pagina dice che la creazione delle sandbox è disattivata al momento, non sono ancora aperte.
- 2Ogni sandbox arriva con staff, servizi, clienti e prenotazioni di esempio, e una prima chiave di prova con tutti i permessi. Le chiavi di prova iniziano con bk_test_ e quelle reali con bk_live_. Crea altre chiavi e altri webhook nell'area di gestione della sandbox, sotto Settings, poi API & monitoring.
- 3Una chiave di prova funziona solo su una sandbox, e una chiave reale solo su un'attività reale. Il contrario viene rifiutato prima che venga eseguito qualcosa, con 403 LIVEMODE_MISMATCH, e ogni risposta indica in livemode che tipo di attività ha raggiunto.
- 4Quello che la sandbox avrebbe inviato è sotto Outbox nella sua area di gestione, e ogni pagamento simulato che ha fatto è sotto Test payments, lì accanto: pagato, rifiutato, abbandonato o rimborsato. Le sue pagine di pagamento simulate hanno i pulsanti Pay (test), Decline (test) e Abandon invece di un modulo per la carta. Non scrivere mai il numero di una carta vera in una sandbox. Il simulatore fa succedere gli eventi subito, come il pagamento di un acconto.
- 5I pagamenti possono anche passare dalla modalità di test di Stripe invece che dal simulatore, dove è disponibile. In Test payments, scegli Connect a Stripe test account e compila le pagine di Stripe solo con i dati di prova di Stripe, mai con il tuo vero documento d'identità o il tuo conto bancario. Se ti fermi a metà, Continue on Stripe ti riporta lì, e Check again mostra se l'account è pronto. Poi scegli Turn on Stripe test mode. I nuovi pagamenti aprono la pagina di pagamento di Stripe, dove paghi con una carta di prova come 4242 4242 4242 4242, e vengono elencati in Finance. Non si muovono soldi veri. Torna ai pagamenti simulati quando vuoi.
- 6Reset svuota una sandbox e la riempie con nuovi dati di esempio, e Delete la elimina, entrambi dalla pagina delle tue sandbox. Una sandbox che nessuno usa per 30 giorni viene eliminata, e ricevi un'email 7 giorni prima.
- 7Ogni chiamata, con esempi, è in Testing with a sandbox su /developers/testing, e in markdown su /developers/testing.md. Quando funziona, Going live su /developers/going-live spiega come passare alla chiave di un'attività reale.
Guide collegate
Was this helpful?
Non hai trovato quello che cercavi?
Contatta l'assistenza oppure vai alle domande frequenti.