open IDV session

Developing

POST

/wallet/{walletId}/idv-session

open a IDV seesion

Webhook callback events of WalletIDVSession

eventType: WalletIDVSession
referenceId: id of the IDV session
event values:

WalletIdvSessionStarted

WalletIdvSessionSubmitted

WalletIdvSessionApproved

WalletIdvSessionDeclined

WalletIdvSessionReview

Callback event example:

{
  "eventId": "ET123000003",
  "eventType": "WalletIDVSession",
  "event": "WalletIdvSessionApproved",
  "referenceId": "IDV159760836849952",
  "description": ""
}

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/json

Example

{
    "idType": "PASSPORT",
    "country": "FR"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/wallet//idv-session' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "idType": "PASSPORT",
    "country": "FR"
}'

Responses

🟢200OK

application/json

Body

Example

{
    "identityVerifyId": "IDV1200232221241",
    "walletId": "WA1421519406235680",
    "sessionUrl": "https://magic.falcon-1-eu.veriff.me/v/XXX"
}

Modified at 2025-07-22 06:30:30

sync sumsub shareToken

get IDV session detail

open IDV session

Webhook callback events of WalletIDVSession#

Request

Request Code Samples

Responses

Webhook callback events of WalletIDVSession