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
AuthorizationBearer <token>

In: header

Apple Identity Access CSR payload

teamIdstring

Team ID of the iOS app.

merchantIdstring

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
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}
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}
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?