Stash Documentation
Integration GuidesAPI ReferencePartner with usChangelog

Generate authenticated URL

Generates an authenticated URL for a specific target (home or loyalty) for a user. This endpoint is used for server-side URL generation.

POST
/sdk/server/generate_url

Authorization

X-Stash-Api-Key<token>

DEPRECATED: API key authentication is no longer supported for new shops. Use HMAC authentication via the x-stash-hmac-signature header instead for the best security. Existing shops may continue using their X-Stash-Api-Key for server-to-server operations, but are encouraged to migrate to HMAC as soon as possible.

In: header

Request Body

user?pie.sdk.urls.User

User information for URL generation

target?pie.sdk.urls.GenerateAuthenticatedUrlRequest.Target

Target destination for the generated URL

Default"DEFAULT"
Value in"DEFAULT" | "HOME" | "LOYALTY" | "ROOT" | "STORE" | "DAILY_STREAK"

Response Body

curl -X POST "https://test-api.stash.gg/sdk/server/generate_url" \  -H "Content-Type: application/json" \  -d '{}'
{
  "url": "string"
}
{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string",
      "property1": null,
      "property2": null
    }
  ]
}

How is this guide?

Get prices GET

Retrieves uploaded pricing sheet data for the shop associated with the API key, filtered by region. Returns paginated price entries.

Generate Checkout POST

Generates a quick payment URL for server-side operations. This endpoint is used internally for creating payment links with user information.