SAML Signing Certificates
How SAML Signing Certificates works in Paycux, what it is for, and the smallest setup that gets it running.
SAML Response Signing Certificate
Paste the provider's metadata URL into the connection. Paycux reads the signing certificate and endpoints from it and re-reads them on a schedule, so a certificate rotation does not break the connection.
Static metadata
If the provider only offers a metadata file rather than a URL, upload the XML instead. Static metadata does not auto-refresh — set a calendar reminder for the certificate expiry date.
Sample scenario
Sample scenario is handled by SAML Signing Certificates 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.
Verifying the SAML response
Verify the setup end to end before you hand it to a customer. Run the flow from a private browser window so no existing session masks a broken step.
- 1Open the connection in the dashboard and confirm its status reads Active.
- 2Start the flow from your application, not from the provider, so the redirect URI is exercised.
- 3Sign in as a test user and confirm the profile arrives with an email address.
- 4Check the connection's event list — a successful sign-in appears within a few seconds.
Planning considerations
Planning considerations is handled by SAML Signing Certificates 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.
Certificate expiration
Certificate expiration applies specifically to SAML Signing Certificates. It behaves the same in both environments, and the values it depends on are visible in the dashboard for the environment you have selected.
If the behaviour you see does not match this description, check which environment your API key belongs to before anything else — a staging key against production data is the most common cause.
Monitored metadata versus manual upload
Monitored metadata versus manual upload applies specifically to SAML Signing Certificates. It behaves the same in both environments, and the values it depends on are visible in the dashboard for the environment you have selected.
If the behaviour you see does not match this description, check which environment your API key belongs to before anything else — a staging key against production data is the most common cause.
Renewing certificates
Renewing certificates applies specifically to SAML Signing Certificates. It behaves the same in both environments, and the values it depends on are visible in the dashboard for the environment you have selected.
If the behaviour you see does not match this description, check which environment your API key belongs to before anything else — a staging key against production data is the most common cause.
Monitored metadata
Monitored metadata applies specifically to SAML Signing Certificates. It behaves the same in both environments, and the values it depends on are visible in the dashboard for the environment you have selected.
If the behaviour you see does not match this description, check which environment your API key belongs to before anything else — a staging key against production data is the most common cause.