Skip to content
Single Sign-On

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.

  1. 1Open the connection in the dashboard and confirm its status reads Active.
  2. 2Start the flow from your application, not from the provider, so the redirect URI is exercised.
  3. 3Sign in as a test user and confirm the profile arrives with an email address.
  4. 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.