Environments
The Pismo platform provides separate environments for testing and production.
-
Test environment—A non‑production environment used to test new and updated features.
-
Production environment—A live environment used to process actual customer data.
Your support team sets up access to these environments when you onboard. For more information, refer to Onboarding for new customers.
The endpoint you use determines the environment to which your call is routed, so each type of request has multiple endpoints associated with it, depending on the target environment. For example, if you send a request to the test environment, you'll need to use a different endpoint to send the same request to production.
For information about authentication, see Security.
Endpoint structure
An endpoint is a URL that you can use to send a request to the Pismo platform. An endpoint has the following syntax.
protocol:hostname/[prefix]/API version/pathHere's a sample endpoint that directs a request to Pismo's test environment:
https://sandbox.pismolabs.io/accounts/v1/accounts/10/balances/The following table explains the different components in the sample endpoint.
| Name | Component | Details |
|---|---|---|
| protocol | https:// | Always https://. This means the connection is encrypted and your data is safe. |
| hostname | sandbox.pismolabs.io | Server name that identifies the environment. |
| prefix | accounts | Name of the service you are accessing. |
| API version | v1 | Version of the API the endpoint uses. Used to avoid breaking changes to existing paths. |
| path | accounts/10/balances | Path of the endpoint that specifies the method called by the endpoint. This follows REST API design standard. |
Components of a Pismo environment
Every Pismo environment consists of the same components. Understanding a few core concepts will help you identify issues across environments.
PCI endpoints vs. non-PCI endpoints
PCI (Payment Card Industry) certification requires extra security measures for endpoints that pass or return sensitive data, such as PAN and CVV. The following services use PCI endpoints (in both the test and production environments):
/cardsonfile//cards-tokenization//embossing//payment-methods//payment-methods-configs//pcicards//transactionsgateway/
Hostnames
A hostname is the entry point for an environment. Each environment has two servers:
-
Non-PCI—Server that handles most API calls.
-
PCI—Server than handles calls to PCI-related endpoints.
Hostnames for the test environment
Use the following servers in the test environment:
| Type of endpoint | Hostname |
|---|---|
| Non-PCI | sandbox.pismolabs.io |
| PCI | gw-pci.pismolabs.io |
Hostnames for the production environment
In production, Pismo provides hostnames that are based on the specifics of your implementation. Ask your Pismo representative about the hostnames to use in production.
In the test environment, some endpoints might work with either hostname. However, in production, you must use the appropriate hostname.