Point of Sale Developer Guide for Non Hyperforce Users
Invoking Point of Sale APIs is a two-step process. This topic describes the steps and includes sample responses.
For a comprehensive list of APIs and SPIs, see Point of Sale API Specifications.
In 2024, Salesforce acquired PredictSpring, a provider of modern retail point-of-sale (POS) software built natively in the cloud. PredictSpring was renamed Retail Cloud and is now called Point of Sale. You may still see references to PredictSpring or Retail Cloud in the Point of Sale app and in our documentation (for example, in API header names).
Find the keys needed to use Point of Sale APIs in CMS by going to Advanced > Merchant Configuration > Developer Credentials.
- Staging API Base URL: https://api.predictspring.com/staging/service
- Production API Base URL: https://api.predictspring.com/prod/service
- Staging OAuth2 URL: https://staging-oauth2.predictspring.com/oauth2/token
- Production OAuth2 URL: https://prod-oauth2.predictspring.com/oauth2/token
- Production: 10 requests per second and 100,000 requests per month.
- Staging: 10,000 requests per month.
For additional API volume, contact Salesforce Customer Support.
To use Point of Sale APIs, complete a two-step authentication process. First, obtain an OAuth token. Then, use that token to make API calls.
Sample Response:
Extract the access token value. This token is required for Step 2 to invoke the Point of Sale API.
The token is valid for the expiry period as specified in expired_in in seconds.
Pass the access token as PredictSpring-Token when invoking the Point of Sale API.
Make sure that Content-Type is set to application/json in all the requests.
Invoke Point of Sale API with the below headers:
- PredictSpring-Secret (this is an encrypted string you get from Point of Sale)
- PredictSpring-Token
- X-api-key
- Content-Type: application/json
x-api-key is the Merchant API Key in the UI.
Here's a sample request to create promotions in a staging environment.