Actions
How Actions works in Paycux, what it is for, and the smallest setup that gets it running.
Introduction
Actions is part of the Paycux platform. This page explains what it does, when to reach for it, and the smallest working setup you can ship.
Everything below applies to both environments. Build and test in staging, then promote the same configuration to production without changing your code — only the API key and client ID differ.
Action types
Action types is handled by Actions rather than by your application code. Paycux exposes it through the same API surface as the rest of the platform, so the client you already configured needs no additional setup.
Configuration lives in the dashboard and is versioned per environment. Change it in staging, confirm the behaviour, then apply the same change to production.
Configuring actions
Configuring actions is handled by Actions rather than by your application code. Paycux exposes it through the same API surface as the rest of the platform, so the client you already configured needs no additional setup.
Configuration lives in the dashboard and is versioned per environment. Change it in staging, confirm the behaviour, then apply the same change to production.
Set up your endpoint
Set up your endpoint is handled by Actions rather than by your application code. Paycux exposes it through the same API surface as the rest of the platform, so the client you already configured needs no additional setup.
Configuration lives in the dashboard and is versioned per environment. Change it in staging, confirm the behaviour, then apply the same change to production.
Register your endpoint
Register your endpoint is handled by Actions rather than by your application code. Paycux exposes it through the same API surface as the rest of the platform, so the client you already configured needs no additional setup.
Configuration lives in the dashboard and is versioned per environment. Change it in staging, confirm the behaviour, then apply the same change to production.
Choosing error handling behavior
If something does not work, check these first — they cover the large majority of failed setups:
- The values were pasted into the wrong environment. Staging and production hold separate configuration.
- A trailing slash or stray whitespace in the ACS URL or redirect URI. Both are matched exactly.
- The connection is saved but not activated. An inactive connection returns
connection_inactive. - Attribute names differ from what the mapping expects, so the user is created without an email address.
Every failed authentication is recorded with a reason on the connection's page in the dashboard. Start there before reading application logs.
Implement your endpoint
Implement your endpoint is handled by Actions rather than by your application code. Paycux exposes it through the same API surface as the rest of the platform, so the client you already configured needs no additional setup.
Configuration lives in the dashboard and is versioned per environment. Change it in staging, confirm the behaviour, then apply the same change to production.
AValidate the requests using the SDK
Official SDKs are published for Node.js, Python, Ruby, Go, PHP, Java and .NET. They share the same method names, so a snippet translates between languages with little more than syntax changes.
Each SDK reads PAYCUX_API_KEY from the environment by default and retries idempotent requests on transport errors.