Developer Quickstart

This quickstart guides you through interacting with the Pcnaid Lifecycle Manager Control Plane API and verifying an Apple Pay checkout domain.

Prerequisites

An authorized merchant account on https://lifecyclemanager.app.
An Auth0 Bearer access token containing the read:merchants and write:merchants scopes.
Terminal access with curl or HTTP client installed.

Step 1: Query your merchant profile

All API routes are served from the production control plane at https://api.lifecyclemanager.app. Retrieve your merchant identity and current setup state:

curl --request GET "https://api.lifecyclemanager.app/applepay-lifecycle/v1/merchants/me" \
  --header "Authorization: Bearer <AUTH0_ACCESS_TOKEN>" \
  --header "Content-Type: application/json"

A successful response (200 OK) returns your merchant profile:

{
  "id": "00000000-0000-4000-8000-000000000001",
  "businessName": "Acme Widgets, Inc.",
  "environment": "sandbox",
  "email": "developer@acme.example",
  "applePayActive": true,
  "stripeAccountId": "acct_123",
  "stripeChargesEnabled": true,
  "planId": "pro",
  "signupCompleted": true
}

Step 2: Verify domain association

For your checkout subdomain (e.g., applepay.acmewidgets.com), verify that Apple’s cryptographic association file is served correctly:

curl --request GET "https://applepay.acmewidgets.com/.well-known/apple-developer-merchantid-domain-association"

The response should return the raw PKCS#7 signed file provisioned by Pcnaid’s edge KV from our Payment Service Provider credentials.

Step 3: Inspect team access & members

List the active members and pending invitations for your tenant:

curl --request GET "https://api.lifecyclemanager.app/applepay-lifecycle/v1/team" \
  --header "Authorization: Bearer <AUTH0_ACCESS_TOKEN>"

Step 4: Open a diagnostic support ticket

Create a ticket to communicate directly with Pcnaid’s integration engineers:

curl --request POST "https://api.lifecyclemanager.app/applepay-lifecycle/v1/support/tickets" \
  --header "Authorization: Bearer <AUTH0_ACCESS_TOKEN>" \
  --header "Content-Type: application/json" \
  --data '{
    "subject": "Sandbox domain validation check",
    "body": "Verified association file on checkout subdomain. Proceeding with end-to-end payment sheet tests.",
    "severity": "low"
  }'

Next, consult the full Control Plane API Reference for comprehensive endpoint specifications.

Start here

Documentation hubs

Legal

Shared legal

Developer Quickstart

Developer Quickstart

Prerequisites

Step 1: Query your merchant profile

Step 2: Verify domain association

Step 3: Inspect team access & members

Step 4: Open a diagnostic support ticket

​Developer Quickstart

​Prerequisites

​Step 1: Query your merchant profile

​Step 2: Verify domain association

​Step 3: Inspect team access & members

​Step 4: Open a diagnostic support ticket

Developer Quickstart

Prerequisites

Step 1: Query your merchant profile

Step 2: Verify domain association

Step 3: Inspect team access & members

Step 4: Open a diagnostic support ticket