Skip to main content

Introduction

The topi Seller Sandbox is an environment where you can build and test your integration before going live.

As it is identical in behavior to the live environment, all API endpoints behave as documented in the docs at https://developer.topi.eu.

We recommend that when building your integration, you follow the step-by-step integration guide while pointing your integration to the sandbox API base URL:

https://seller-api-sandbox.topi-sandbox.eu/

Authentication​

The authentication process in the sandbox is the same as in the production environment. You can learn more about it in the authentication guide here.

Obtaining your token​

To authenticate in the sandbox, you need to obtain a sandbox token. Use the sandbox credentials previously shared with you as your CLIENT_ID and CLIENT_SECRET

Example curl:

curl -u $CLIENT_ID:$CLIENT_SECRET \
-d 'grant_type=client_credentials&scope=client' \
'https://identity.topi-sandbox.eu/oauth2/token'

Catalog​

For details on syncing your catalog, refer to the Syncing your Catalog section of the Integration Guide.

Note that in the sandbox, all your products will be automatically marked as supported, and there is a limit of 10,000 items you can import.

If you want to test the behavior when a product is unsupported, you can use our "mark_product_unsupported" simulation scenario.

Webhooks​

For details on setting up your webhook, refer to our Setting up webhooks Guide.