Retry a PSC Session

PUT

/v2.01/:ClientId/identity-verifications/:IdvSessionId/pscs/:PscId/retry

PUT

/v2.01/:ClientId/identity-verifications/:IdvSessionId/pscs/:PscId/retry

curl -X PUT https://api.sandbox.mangopay.com/v2.01/ClientId/identity-verifications/IdvSessionId/pscs/PscId/retry \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "body": {
    "DateOfBirth": 419904000,
    "Email": "john.doe@example.com",
    "FirstName": "John",
    "LastName": "Doe"
  }
}'

{
  "Id": "psc_x_01KXQN5Y7NYQBYBGA9ESQ8KBAD",
  "FirstName": "John",
  "LastName": "Doe",
  "Email": "john.doe@example.com",
  "DateOfBirth": 419904000,
  "Country": "FR",
  "Nationality": "FR",
  "PscType": "LEGAL_REP_AND_UBO",
  "Status": "PENDING_VALIDATION",
  "CreationDate": 1784279136,
  "ValidationDate": null,
  "HostedUrl": "https://user-verification.sandbox.mangopay.com/6a58df8c284bf54f4b788cae?sessionId=6a82c6c64000005f004d8716&theme={\\\"stepIconColor\\\"%3A\\\"%23867EFF\\\"%2C\\\"inputFieldBorderColor\\\"%3A\\\"%23867EFF\\\"%2C\\\"continueButtonValidColor\\\"%3A\\\"%2389E481\\\"%2C\\\"continueButtonInvalidColor\\\"%3A\\\"%2389E481\\\"%2C\\\"logo\\\"%3A\\\"https%3A%2F%2Fres.cloudinary.com%2Fmangopay-dev%2Fimage%2Fupload%2Fv1772722797%2Fmrebvcrkjgxnguvoelgj.png\\\"%2C\\\"logoPosition\\\"%3A\\\"top-right\\\"}"
}

Retry a PSC Session based on its Id. Send an empty body ({}) to use the existing details declared for the individual and only retry the liveness check, or else send updated details in the request body.

If the PSC’s Status is PENDING_VALIDATION, the existing session link is returned. If the PSC’s Status is VALIDATED or REJECTED, a new session link is generated. A PSC whose Status is ABANDONED cannot be retried. To add a missing PSC, contact Mangopay via the Dashboard, who will create the new PSC and provide you with a session link.

Retry a PSC Session based on its `Id`. Send an empty body (`{}`) to use the existing details declared for the individual and only retry the liveness check, or else send updated details in the request body. If the PSC's `Status` is `PENDING_VALIDATION`, the existing session link is returned. If the PSC's `Status` is `VALIDATED` or `REJECTED`, a new session link is generated. A PSC whose `Status` is `ABANDONED` cannot be retried. To add a missing PSC, contact Mangopay <a href="https://hub.mangopay.com/" target="_blank">via the Dashboard</a>, who will create the new PSC and provide you with a session link. [Read more about the multi-session PSC flow](/guides/users/verification/hosted/business) **→**

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

If your platform is using a proxy to take SCA-triggering action on behalf of users, you also need to integrate mTLS authentication and use the api-mtls base URL.

Bearer authentication of the form `Bearer <token>`, where token is your auth token. If your platform is using a [proxy](/guides/sca/proxy-management) to take SCA-triggering action on behalf of users, you also need to integrate [mTLS authentication](/guides/sca/platform) and use the `api-mtls` base URL.

Path parameters

ClientIdstringRequired

Platform's API account identifier, associated with the API key.

IdvSessionIdstringRequired

The unique identifier of the IDV Session.

PscIdstringRequired

The unique identifier of the PSC.

Request

This endpoint expects an object.

FirstNamestringOptional

The first name of the PSC.

LastNamestringOptional

The last name of the PSC.

EmailstringOptional

The email address of the PSC.

DateOfBirthintegerOptional

Unix timestamp (UTC) of the date of birth of the PSC.

Response

Success

IdstringOptional

The unique identifier of the PSC.

FirstNamestringOptional

The first name of the PSC.

LastNamestringOptional

The last name of the PSC.

EmailstringOptional

The email address of the PSC.

DateOfBirthintegerOptional

Unix timestamp (UTC) of the date of birth of the PSC.

CountrystringOptional

The country of the PSC (ISO 3166-1 alpha-2 format).

NationalitystringOptional

The nationality of the PSC (ISO 3166-1 alpha-2 format).

PscTypestringOptional

The type of the PSC:

LEGAL_REP – The PSC is a legal representative only.
LEGAL_REP_AND_UBO – The PSC is both a legal representative and a beneficial owner.
UBO – The PSC is a beneficial owner only.

StatusstringOptional

The status of the PSC session:

PENDING_VALIDATION – The PSC session link has been generated and is awaiting completion.
VALIDATED – The PSC session was validated.
REJECTED – One or more checks failed, or the PSC did not complete the verification within the allowed timeframe. By default, the PSC Session expires 7 days after its CreationDate, but if the PSC’s liveness step has been started (the QR code was generated), it expires 1 hour after the liveness step started instead.
ABANDONED – The PSC session was abandoned by Mangopay, for example if it was a duplicate of another declared PSC.

CreationDateintegerOptional

Unix timestamp (UTC) of the date and time the object was created.

ValidationDateinteger or nullOptional

Unix timestamp (UTC) of the date and time the PSC session was validated. Returns null if not yet validated.

HostedUrlstringOptional

The URL to redirect the PSC to for the hosted verification session.

Errors

404

Not Found Error