light-mode-image
Learn
API Reference

Wallet providers

Create a wallet provider

Create wallet provider

Creates a wallet provider that can present mDocs for online verification.

Analytic events

  • CREDENTIAL_PRESENTATION_WALLET_PROVIDER_CREATE_START
  • CREDENTIAL_PRESENTATION_WALLET_PROVIDER_CREATE_SUCCESS
  • CREDENTIAL_PRESENTATION_WALLET_PROVIDER_CREATE_FAIL
POST/v2/presentations/wallet-providers

Authorization

AuthorizationBearer <token>

In: header

Request Body

Wallet provider payload

namestring

Unique identifier for the wallet. This field is compared against the wallet identifier defined in the request by the Verifier Web SDK. Value must be unique amongst configured wallet providers on your tenant.

openid4vpConfigurationobject
curl -X POST "https://example.vii.au01.mattr.global/v2/presentations/wallet-providers" \  -H "Content-Type: application/json" \  -d '{    "name": "Example wallet provider",    "openid4vpConfiguration": {      "authorizationEndpoint": "com-example.wallet://"    }  }'
{
  "id": "e63a2e46-5afa-48f9-bcc2-2114cf5f331b",
  "name": "Example wallet provider",
  "openid4vpConfiguration": {
    "authorizationEndpoint": "com-example.wallet://"
  }
}
{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}

Retrieve all wallet providers

Retrieve all wallet providers

Retrieves all existing wallet providers that can present mDocs for online verification.

Analytic events

  • CREDENTIAL_PRESENTATION_WALLET_PROVIDER_RETRIEVE_LIST_START
  • CREDENTIAL_PRESENTATION_WALLET_PROVIDER_RETRIEVE_LIST_SUCCESS
  • CREDENTIAL_PRESENTATION_WALLET_PROVIDER_RETRIEVE_LIST_FAIL
GET/v2/presentations/wallet-providers

Authorization

AuthorizationBearer <token>

In: header

curl -X GET "https://example.vii.au01.mattr.global/v2/presentations/wallet-providers"
[
  {
    "id": "e63a2e46-5afa-48f9-bcc2-2114cf5f331b",
    "name": "Example wallet provider",
    "openid4vpConfiguration": {
      "authorizationEndpoint": "com-example.wallet://"
    }
  }
]

Retrieve a wallet provider

Retrieve a wallet provider

Retrieves an existing wallet provider that can present mDocs for online verification.

Analytic events

  • CREDENTIAL_PRESENTATION_WALLET_PROVIDER_RETRIEVE_START
  • CREDENTIAL_PRESENTATION_WALLET_PROVIDER_RETRIEVE_SUCCESS
  • CREDENTIAL_PRESENTATION_WALLET_PROVIDER_RETRIEVE_FAIL
GET/v2/presentations/wallet-providers/{walletProviderId}

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

walletProviderIdstring

Unique identifier for the wallet provider.

Formatuuid
curl -X GET "https://example.vii.au01.mattr.global/v2/presentations/wallet-providers/281d20b3-42a3-40dd-b29a-115ff32b02b7"
{
  "id": "e63a2e46-5afa-48f9-bcc2-2114cf5f331b",
  "name": "Example wallet provider",
  "openid4vpConfiguration": {
    "authorizationEndpoint": "com-example.wallet://"
  }
}
{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}

Update a wallet provider

Update a wallet provider

Updates an existing wallet provider that can present mDocs for online verification.

Analytic events

  • CREDENTIAL_PRESENTATION_WALLET_PROVIDER_UPDATE_START
  • CREDENTIAL_PRESENTATION_WALLET_PROVIDER_UPDATE_SUCCESS
  • CREDENTIAL_PRESENTATION_WALLET_PROVIDER_UPDATE_FAIL
PUT/v2/presentations/wallet-providers/{walletProviderId}

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

walletProviderIdstring

Unique identifier for the wallet provider.

Formatuuid

Request Body

Wallet provider payload

namestring

Unique identifier for the wallet. This field is compared against the wallet identifier defined in the request by the Verifier Web SDK. Value must be unique amongst configured wallet providers on your tenant.

openid4vpConfigurationobject
curl -X PUT "https://example.vii.au01.mattr.global/v2/presentations/wallet-providers/281d20b3-42a3-40dd-b29a-115ff32b02b7" \  -H "Content-Type: application/json" \  -d '{    "name": "Example wallet provider",    "openid4vpConfiguration": {      "authorizationEndpoint": "com-example.wallet://"    }  }'
{
  "id": "e63a2e46-5afa-48f9-bcc2-2114cf5f331b",
  "name": "Example wallet provider",
  "openid4vpConfiguration": {
    "authorizationEndpoint": "com-example.wallet://"
  }
}
{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}
{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}

Delete a wallet provider

Delete a wallet provider

Deletes an existing wallet provider that can present mDocs for online verification.

Analytic events

  • PRESENTATION_WALLET_PROVIDER_DELETE_START
  • PRESENTATION_WALLET_PROVIDER_DELETE_SUCCESS
  • PRESENTATION_WALLET_PROVIDER_DELETE_FAIL
DELETE/v2/presentations/wallet-providers/{walletProviderId}

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

walletProviderIdstring

Unique identifier for the wallet provider.

Formatuuid
curl -X DELETE "https://example.vii.au01.mattr.global/v2/presentations/wallet-providers/281d20b3-42a3-40dd-b29a-115ff32b02b7"
Empty
{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}

How would you rate this page?

Trusted issuers

Previous Page

Presentation sessions

Next Page

On this page

Create a wallet providerRetrieve all wallet providersRetrieve a wallet providerUpdate a wallet providerDelete a wallet provider