> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paylead.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Program × Developer: diagnosing common WebApp (MFP) SSO and WebView issues.

Common symptoms when integrating the Paylead WebApp over SSO, and how to resolve
them. Most issues trace back to [session durations](/program/webapp/authentication#recommended-durations)
or [WebView configuration](/program/webapp/configuration).

<AccordionGroup>
  <Accordion title="Authentication screen shown frequently" icon="triangle-alert">
    **Possible causes:**

    * Partner IdP session expired → adjust its duration so it is **≥** the Paylead
      IdP session.
    * Cookies not persisted → check the
      [WebView configuration](/program/webapp/configuration#platform-setup).
    * WebView recreated on each open → reuse the same instance.
  </Accordion>

  <Accordion title="Authentication screen shown during activity" icon="clock">
    **Possible causes:**

    * The activity generates no server requests → set up a "keep-alive".
    * Cookies not sent on some requests → check `withCredentials`.
  </Accordion>

  <Accordion title="Unexpected behaviour or hard-to-diagnose support cases" icon="search">
    **Possible cause:**

    * The User-Agent does not contain the `PayleadWebView` suffix.

    **Fix:**

    * Keep the device's default User-Agent and append `PayleadWebView` at the end
      (see [User-Agent identification](/program/webapp/configuration#user-agent-identification-required)).
  </Accordion>
</AccordionGroup>

## What's next

<CardGroup cols={2}>
  <Card title="Bridge releases" icon="newspaper" href="/program/webapp/bridge/releases">
    Every published Mobile Bridge version, with the schema download.
  </Card>

  <Card title="API reference" icon="code" href="/program/api/releases">
    Browse the Program API endpoints and download the OpenAPI specs.
  </Card>
</CardGroup>