Download collection
Requests grouped by customers, enrolments, transactions, cards, webhooks,
locations, pushes, and marketplace operations.
Download environment
Production base URL and safe placeholder variables. It contains no live
credential.
Import and connect
1
Import both files
In Postman, choose Import, select the collection and environment JSON
files, then select Perkstar Production in the environment menu.
2
Add a test key
Create a read-only test key in Dashboard → Settings → API keys. Replace
the
api_key environment value with that key and mark the value as secret.3
Run the connection check
Open Marketplace → Auth check + org context and send the request. A
successful response identifies the connected business and available cards.
4
Run a read-only folder
Run the Cards folder first. Collection tests verify the API version,
request ID, and absence of a server error on every response.
Write requests
POST requests use Postman’s{{$guid}} dynamic variable for a fresh
Idempotency-Key. Replace it with a stable business reference when testing a
job that may be replayed from another process. For a manual retry, keep the
resolved key from the first request instead of generating another one.