light-mode-image
Learn
API Reference

Apple Identity Access CSRs

Create an Apple Identity Access certificate signing request

Create an Apple Identity Access CSR

Creates an Apple Identity Access Certificate Signing Request (CSR) that can be uploaded to the Apple Developer Portal.

This certificate contains the public key that will be used to decrypt the response from the Apple Wallet.

Analytic events

  • CREDENTIAL_PRESENTATION_APPLE_IDENTITY_ACCESS_CERTIFICATE_CREATE_START
  • CREDENTIAL_PRESENTATION_APPLE_IDENTITY_ACCESS_CERTIFICATE_CREATE_SUCCESS
  • CREDENTIAL_PRESENTATION_APPLE_IDENTITY_ACCESS_CERTIFICATE_CREATE_FAIL
POST/v2/presentations/certificates/apple-identity-access-certificates

Authorization

AuthorizationBearer <token>

In: header

Request Body

Apple Identity Access CSR payload

teamIdteamId

Team ID of the iOS app.

merchantIdmerchantId

The merchantIdentifier used by PassKit to retrieve credential data.

curl -X POST "https://example.vii.au01.mattr.global/v2/presentations/certificates/apple-identity-access-certificates" \  -H "Content-Type: application/json" \  -d '{    "teamId": "A2B3C4D5E6",    "merchantId": "com.domain.subdomain"  }'
{
  "id": "fd44e792-45ac-11f0-bef8-bb24f133065e",
  "teamId": "A2B3C4D5E6",
  "merchantId": "com.domain.subdomain",
  "csrPem": "string"
}
{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}

Retrieve all Apple Identity Access certificate signing requests

Retrieve all Apple Identity Access CSRs

Retrieves all Apple Identity Access CSRs created by the tenant.

Analytic events

  • CREDENTIAL_PRESENTATION_APPLE_IDENTITY_ACCESS_CERTIFICATE_RETRIEVE_LIST_START
  • CREDENTIAL_PRESENTATION_APPLE_IDENTITY_ACCESS_CERTIFICATE_RETRIEVE_LIST_SUCCESS
  • CREDENTIAL_PRESENTATION_APPLE_IDENTITY_ACCESS_CERTIFICATE_RETRIEVE_LIST_FAIL
GET/v2/presentations/certificates/apple-identity-access-certificates

Authorization

AuthorizationBearer <token>

In: header

curl -X GET "https://example.vii.au01.mattr.global/v2/presentations/certificates/apple-identity-access-certificates"
{
  "nextCursor": "Y3JlYXRlZEF0PTIwMjAtMDgtMjVUMDY6NDY6MDkuNTEwWiZpZD1hNjZmZmVhNS04NDhlLTQzOWQtODBhNC1kZGE1NWY1M2UzNmM",
  "data": [
    {
      "id": "fd44e792-45ac-11f0-bef8-bb24f133065e",
      "teamId": "A2B3C4D5E6",
      "merchantId": "com.domain.subdomain",
      "csrPem": "string"
    }
  ]
}

Retrieve an Apple Identity Access certificate signing request

Retrieve an Apple Identity Access CSR

Retrieves an existing Apple Identity Access CSR.

Analytic events

  • CREDENTIAL_PRESENTATION_APPLE_IDENTITY_ACCESS_CERTIFICATE_RETRIEVE_START
  • CREDENTIAL_PRESENTATION_APPLE_IDENTITY_ACCESS_CERTIFICATE_RETRIEVE_SUCCESS
  • CREDENTIAL_PRESENTATION_APPLE_IDENTITY_ACCESS_CERTIFICATE_RETRIEVE_FAIL
GET/v2/presentations/certificates/apple-identity-access-certificates/{certificateId}

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

certificateIdstring

Unique identifier for the Apple Identity Access CSR.

Formatuuid
curl -X GET "https://example.vii.au01.mattr.global/v2/presentations/certificates/apple-identity-access-certificates/673a20c3-97a3-40dd-b29a-115ff32b02c3"
{
  "id": "fd44e792-45ac-11f0-bef8-bb24f133065e",
  "teamId": "A2B3C4D5E6",
  "merchantId": "com.domain.subdomain",
  "csrPem": "string"
}
{
  "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 an Apple Identity Access certificate signing request

Delete an Apple Identity Access CSR

Deletes an existing Apple Identity Access CSR.

Analytic events

  • CREDENTIAL_PRESENTATION_APPLE_IDENTITY_ACCESS_CERTIFICATE_DELETE_START
  • CREDENTIAL_PRESENTATION_APPLE_IDENTITY_ACCESS_CERTIFICATE_DELETE_SUCCESS
  • CREDENTIAL_PRESENTATION_APPLE_IDENTITY_ACCESS_CERTIFICATE_DELETE_FAIL
DELETE/v2/presentations/certificates/apple-identity-access-certificates/{certificateId}

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

certificateIdstring

Unique identifier for the Apple Identity Access CSR.

Formatuuid
curl -X DELETE "https://example.vii.au01.mattr.global/v2/presentations/certificates/apple-identity-access-certificates/673a20c3-97a3-40dd-b29a-115ff32b02c3"
Empty
{
  "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"
    }
  ]
}

How would you rate this page?

Presentation sessions

Previous Page

Overview

Next Page

On this page

Create an Apple Identity Access certificate signing requestRetrieve all Apple Identity Access certificate signing requestsRetrieve an Apple Identity Access certificate signing requestDelete an Apple Identity Access certificate signing request