API Test Facility

In order to verify that Plaza API partner systems can interact with the Plaza API in a sand boxed environment, a test facility is provided. This facility offers the same API as the production environment but with fixed responses. This implies that no personalized data is used in the test facility and that none of the data that has been sent to the system is stored in a database. Calls to this system will not impact production data and are therefore safe for partners to use while developing their systems.

All error conditions that apply to the production system apply to the test facility too and will result in the same errors as on the production system. Please consult the Error codes and messages page for more information.

Root endpoint

The technical specifications of the interfaces are the same as those of the production system. However, the root endpoint is different. The test version of the API can be reached by connecting to:

https://test-plazaapi.bol.com

Our test environment currently only works with version 2.0 endpoints.

Process status

Because the data on the test environment is static, you will not be able to retrieve a process-status for your specific test request. We have put some default statuses in place that you can query in order to test if your process-status request is functional (see below). All other process-IDs will result in a HTTP 404 (Not Found) result.

  • 123: Mimics a process request that was handled successfully.
  • 456: Mimics a process request that resulted in errors.
  • 789: Mimics a process request that has not been finalized yet.

Note: The DateTime fields contain the date and time of generating the XML. All other fields are static.