View an IDV Session

Path parameters

IdvSessionId

string

required

The unique identifier of the IDV Session.

Responses

200

string

Max length: 128 characters (see data formats for details)The unique identifier of the object.

Tag

string

Max. length: 255 charactersCustom data that you can add to this object.

HostedUrl

string

The URL to redirect the user to for the hosted identity verification session.

ReturnUrl

string

Max. length: 500The URL to which the user is returned after the hosted identity verification session, regardless of the outcome.

Status

string

The status of the overall IDV Session:

PENDING – The unique HostedUrl for the session has not yet been submitted by the user. This temporary state can transition to VALIDATED, REFUSED, or REVIEW.
REVIEW – One or more automated checks was neither successful nor refused, so the session was sent for manual review by Mangopay’s teams. This temporary state is only applicable to Legal users and can transition to REFUSED or VALIDATED.
VALIDATED – - The session was validated and the User became KYC/KYB verified (indicated by the User object’s KYCLevel). When the Status changes to VALIDATED, the verified data in Checks.Data is used to replace existing data in the User object.
REFUSED – The session was refused and the User is not KYC/KYB verified. The Checks.CheckStatus shows which checks were REFUSED and the Checks.Reasons shows the refused reason types and comment (which is custom text in the case of manual review for Legal users).
OUT_OF_DATE – The session is not valid because the user’s KYC/KYB verification status was downgraded by Mangopay.

UserId

string

The unique identifier of the user.

CreationDate

Unix timestamp

The date and time at which the object was created.

LastUpdate

Unix timestamp

The date and time at which the session was last updated.

Checks

array (object)

The checks performed automatically during the session.This array is empty when Status is PENDING and may contain any number of objects depending on the outcome.

Show properties

CheckId

string

The unique identifier of the verification check.

Type

string

Type of check carried out during the session depending on the user type:

IDENTITY_DOCUMENT_VERIFICATION - Verifies the authenticity of the identity document, the liveness of the selfie, and that the selfie matches the identity document photo.
IDV_AGE_CHECK - Checks whether the individual on the identity document meets the minimum age requirement for Mangopay users (age 18).
BUSINESS_VERIFICATION - Looks up the business details entered by the user during the session in the national registry to find a match.
IDV_NAME_MATCH_CHECK - Checks whether the first name, last name and date of birth of the identity document match the FirstName, LastName, and Birthday of the Natural user object or LegalRepresentative of the Legal user object.
BUSINESS_NAME_MATCH - Checks whether the name on the identity document is present in the name of the registered sole proprietor in the relevant national registry.
BUSINESS_INSIGHTS_MATCH - Checks whether the name on the identity document matches one of the directors listed in the national registry, and whether the PSC data declared in the session is coherent with the PSC data in the registry.

For information on which checks are performed for which user type and in which cases, see the user flows and checks performed.

CheckStatus

string

Returned values: VALIDATED, REFUSEDThe status of the verification check.

Reasons

array (object)

The reasons that the check was refused, which may be returned if CheckStatus was REFUSED (depending on the check type).

Show properties

Type

string

The type of the reason. For more details, see refusals.

Value

string

The explanation of the reason. If the refusal was automatic, this is a preset string. For Legal users, if the refusal follows a manual review, this is a custom explanation from the person who conducted the review.

CreationDate

Unix timestamp

The date and time at which the check was created.

LastUpdate

Unix timestamp

The date and time at which the check was last updated.

Data

array (object)

The data extracted and verified during the check.This array may be empty if no data was extracted or is not applicable for the check.

Show properties

Type

string

The type of the data.For a Natural user:

FIRST_NAME
LAST_NAME
BIRTHDATE

For a Legal user:

COMPANY_NAME
COMPANY_NUMBER
LEGAL_REPRESENTATIVE_FIRST_NAME
LEGAL_REPRESENTATIVE_LAST_NAME
LEGAL_REPRESENTATIVE_BIRTHDATE

Value

string

The value of the data. The value may be null or an empty string if data extraction was not possible but the check was still carried out.

// GET has no body parameters

{
    "Id": "idnver_01JTGFRGJTHCKRZWAGSV1ZEF3W",
    "Tag": "Created using the Mangopay API Postman collection",
    "HostedUrl": "https://user-verification.sandbox.mangopay.com/6810d9b2c2885039758599bc?sessionId=6818d4082500001000a083b8&redirectURL=https%3A%2F%2Fexample.com%2F",
    "ReturnUrl": "https://example.com/",
    "Status": "PENDING",
    "UserId": "user_m_01JTG7NDTE52MZCCF50QHJ870A",
    "CreationDate": 1746457608,
    "LastUpdate": 1746457608,
    "Checks": []
}

Overview

User management

User verification

Wallets

Cards

Card pay-ins

Banking pay-ins

APM pay-ins

Transfers

Refunds

Disputes

Payouts

FX conversions

Transactions

Echo

Helpers

Platform account

Path parameters

Responses

Overview

User management

User verification

Wallets

Cards

Card pay-ins

Banking pay-ins

APM pay-ins

Transfers

Refunds

Disputes

Payouts

FX conversions

Transactions

Echo

Helpers

Platform account

​Path parameters

​Responses

Path parameters

Responses