The WSO2 API Manager allows having a Production endpoint and a Sandbox endpoint for a given API. The Production endpoint is the actual location of the API, whereas the Sandbox endpoint can be considered as its testing/pre-production environment.
When an API is published through the API Publisher, it is deployed on the API Gateway. By default, this is a single Gateway instance (either external of embedded within the publisher) that will support both Production and Sandbox token types. When an API request is made to the API Gateway, it checks whether the requesting token is of type 'PRODUCTION' or 'SANDBOX' and forwards the request to the appropriate endpoint.
The above API Gateway is known as a Hybrid API Gateway since it passes through both production and sandbox traffic. Instead of having the above approach, it is also possible to publish an API to two different API Gateways. One which will only pass through production traffic and the other which will only pass through sandbox traffic.
Using this approach, the Production API Gateway will only pass through requests which are made using 'PRODUCTION' type tokens and the Sandbox API Gateway will only pass through requests which are made using 'SANDBOX' type tokens. If an invalid token the is received on any of the two Gateways, it will return an error response to the requesting client saying invalid token type.
The <APIGateway> section of the api-manager.xml file contains details of how to configure the API Publisher to publish APIs to different Gateways. Visit this section of the API Manager documentation to see details of the <APIGateway> configuration and a sample configuration of an API Publisher which has 3 Gateways configured.