This page describes how to carry out an example migration from V1 to V2.
It is important to plan a migration. The taxpayer is not involved in the migration process, and shouldn't experience any disruption. Therefore it is recommended to do a migration after the cash-point closing. You may need to do a staged roll-out.
The Management API provides access to API keys.
You should use your existing organization structure and API keys with their associated secret. (The secret is only given when the API key is created.)
For this example, our API key and secret are:
A V2 TSS should be created for each organization (practically, this means that one TSS should be used for each location). Each TSS can handle multiple clients.
We will use a HTTP client (Postman) to run the following requests to set up a basic V2 system:
- Create TSS
- Update TSS (state "UNINITIALIZED")
- Change Admin PIN
- Authenticate Admin
- Update TSS (state "INITIALIZED")
- Create Client
- Logout Admin
The requests can be tested in Postman (see the Postman tutorial), or you can use the terminal command 'curl'.
You can download the relevant Postman files here:
With the V2 system running, we can now proceed to decommission our old V1 system.
We can get a list of our V1 TSS using a
For this example, only one TSS is listed, with the following ID:
We disable this TSS with a
The V1 API documentation contains more details about how to update the TSS.
Note that the TSS cannot be deleted, but its data is preserved. It is still possible to trigger exports even after the TSS is disabled. However, note also that the data cannot be migrated (hence the creation of a new V2 TSS).