Create verifier application
Creates an mDocs online verifier application.
Once created, application instances can be registered and interact with the MATTR VII platform (for example, to verify credential presentations).
Roles
Analytics Events
bearerAuthAuthorizationBearer <token>Verifier application payload
application/json- body
Configuration for an mDocs online verifier web application. Either OID4VP or Digital Credentials API configuration must be provided.
name?stringUnique name to identify the verifier application.
type*"web"Defines the type of the verifier application.
"web"domain*stringFully qualified domain name of verifier application that can create an online presentation session. This ensures the verifier tenant only accepts requests from known and trusted applications. Note that localhost is not supported. Use local tunneling services for testing.
additionalDomains?array<string>List of fully qualified domain names of additional verifier applications who can create an online presentation session.
1 <= itemsopenid4vpConfiguration?Configuration settings that enable verification using OID4VP.
At least one of openid4vpConfiguration or dcApiConfiguration must be provided.
dcApiConfiguration?Configuration settings that enable verification using the Digital Credentials API.
At least one of openid4vpConfiguration or dcApiConfiguration must be provided.
resultAvailableInFrontChannel?booleanIndicates whether or not the verification result should be returned directly to the verifier application (true) or only via a configured back-end (false). Refer to the detailed workflow for more information.
trueVerifier application created
application/json- response
Configuration for an mDocs online verifier web application. Either OID4VP or Digital Credentials API configuration must be provided.
id?stringUnique identifier corresponding to the verifier application.
name?stringUnique name to identify the verifier application.
resultAvailableInFrontChannel?booleanIndicates whether or not the verification result should be returned directly to the verifier application (true) or only via a configured back-end (false). Refer to the detailed workflow for more information.
truetype*"web"Defines the type of the verifier application.
"web"domain*stringFully qualified domain name of verifier application that can create an online presentation session. This ensures the verifier tenant only accepts requests from known and trusted applications. Note that localhost is not supported. Use local tunneling services for testing.
additionalDomains?array<string>List of fully qualified domain names of additional verifier applications who can create an online presentation session.
1 <= itemsopenid4vpConfiguration?Configuration settings that enable verification using OID4VP.
At least one of openid4vpConfiguration or dcApiConfiguration must be provided.
dcApiConfiguration?Configuration settings that enable verification using the Digital Credentials API.
At least one of openid4vpConfiguration or dcApiConfiguration must be provided.
curl -X POST 'https://example.vii.au01.mattr.global/v2/presentations/applications' \ -H 'Content-Type: application/json' \ -d '{ "name": "Example Verifier Web Application", "type": "web", "domain": "example-verifier-web-application.com"}'{ "id": "1ef1f867-20b4-48ea-aec1-bea7aff4964c", "name": "Example Verifier Web Application", "type": "web", "domain": "example-verifier-web-application.com", "additionalDomains": [ "example-verifier-web-application.com" ], "openid4vpConfiguration": { "supportedModes": "all", "redirectUris": [ "https://example-verifier-web-application.com/presentation/callback" ], "display": { "displayMode": "full", "logoImage": { "url": "https://example-logo-image-url.com", "altText": "Logo image" }, "headerText": "Share your information.", "bodyText": "Please scan the QR code to the right to provide information required for this interaction.", "privacyPolicyUrl": "https://example-privacy-policy.com", "primaryColorHex": "#FFFFFF", "privacyPolicyLinkText": "Read our privacy policy", "qrCodeInstructions": "Scan this QR code with your mobile wallet app", "awaitingPresentationText": "QR scanned, waiting for your information" } }, "dcApiConfiguration": { "supportedBrowserPlatforms": { "desktop": true, "mobile": true } }, "resultAvailableInFrontChannel": true}How would you rate this page?