Banqup biedt een klantvalidatieomgeving (CVE, customer validation environment): een sandbox met eigen, gescheiden gegevens. Gebruik ze om een API-integratie te bouwen en te testen, of om functies in de mobiele app uit te proberen, zonder de facturen, betalingen en contacten in je live space te raken.
Wat de sandbox-omgeving is
Gescheiden gegevens. Niets wat je in de sandbox aanmaakt, verschijnt in je live Banqup-space, en niets wat je daar doet, wijzigt je livegegevens.
Dezelfde functies. De sandbox draait op hetzelfde Banqup-platform en dezelfde API als de productieomgeving. Wat in de sandbox werkt, werkt ook in je live space.
Drie toegangspunten.
Webapp: app.cve.btx.banqup.com
Developer Portal, waar ontwikkelaars hun app en API-credentials aanmaken: dev.cve.btx.banqup.com
Ontwikkelaarsdocumentatie van de sandbox: docs.cve.btx.banqup.com
Een API-integratie testen in de sandbox
Start met de Getting started-gids in de sandbox-documentatie. Die legt uit welke authenticatieflow je integratie nodig heeft.
Je ontwikkelaar maakt de app en de client credentials aan op het Developer Portal van de sandbox. Credentials horen bij één omgeving: sandbox-credentials werken niet in productie, en productie-credentials werken niet in de sandbox.
Laat de integratie naar de sandbox-API wijzen. De basis-URL's vind je in de API-gidsen.
In de webapp van de sandbox geeft de beheerder van de space de app toegang tot de space, precies zoals beschreven in Autorisaties voor externe applicaties beheren.
Voer je tests uit. Verkoopfacturen, aankoopfacturen en andere documenten die je aanmaakt, blijven in de sandbox.
Werkt de integratie zoals verwacht? Herhaal dan stap 2 en 4 in productie, met de productiedocumentatie en het Developer Portal van productie.
De sandbox gebruiken in de mobiele app Banqup One
Je hebt geen aparte app nodig voor de sandbox. De Banqup One-app die je al gebruikt, kan vanuit de instellingen overschakelen naar de sandbox.
Open de Banqup One-app en log in zoals gewoonlijk.
Tik op je profiel en dan op Instellingen.
Tik op Andere voorkeuren.
Schakel Sandbox-modus in.
Tik in het bevestigingsvenster op Sandbox-modus inschakelen.
De app schakelt over naar de sandbox en toont alleen sandbox-gegevens. Je livegegevens worden niet gewijzigd en blijven beschikbaar wanneer je terugschakelt.
Om terug te keren naar je livegegevens, volg je hetzelfde pad en tik je op Sandbox-modus uitschakelen. De testgegevens die je hebt aangemaakt, blijven in de sandbox staan voor de volgende keer.
FAQ
Heeft wat ik in de sandbox doe invloed op mijn live Banqup-space?
Nee. De sandbox heeft eigen gegevens. Documenten, contacten en instellingen die je daar aanmaakt, verschijnen nooit in je live space.
Kan ik mijn live credentials gebruiken in de sandbox?
Nee. Apps, client credentials en space-autorisaties worden per omgeving ingesteld. Maak ze aan op het Developer Portal van de sandbox om te testen, en opnieuw op het Developer Portal van productie wanneer je live gaat.
Waar vind ik de API-documentatie van de sandbox?
Op docs.cve.btx.banqup.com. Je vindt er dezelfde gidsen, recepten en API-explorer als in de productiedocumentatie.
Ik heb de mobiele app in sandbox-modus gezet en mijn facturen zijn weg. Wat is er gebeurd?
Er is niets verloren. De app toont de sandbox, die leeg blijft tot je er testgegevens aan toevoegt. Schakel Sandbox-modus uit onder Instellingen > Andere voorkeuren om je livegegevens opnieuw te zien.