Ops Lab Playbook: Domain Commerce + Trust

Last updated: 2026-03-08

1. Purpose and when to use this

Use this module to connect domains, run reconcile workflows, and configure host routes for production traffic.

2. User roles and auth modes

• [Creator]/owner JWT: account-domain create, reconcile, and route lifecycle.
• [Platform Admin] purchase approvals and capacity overrides are documented in Playbooks escalation boundaries.

3. Prerequisites checklist

• Primer completed: Onboarding and API Primer
• Owner JWT for tenant domain actions
• DNS control for the test domain

4. UI onboarding flow

1. Open https://app.10x.in/apps/domain-commerce.
2. Add BYOD domain and inspect initial pending state.
3. Trigger reconcile and monitor progression.
4. Configure route mapping to target handle.

5. API workflow map

1. DC-01: POST /v2/account/domains (owner JWT)
2. DC-02: POST /v2/account/domains/{domain}/reconcile (owner JWT)
3. DC-03: GET /v2/account/domains/{domain} (owner JWT)
4. DC-04: PUT /v2/account/domains/{domain}/routes (owner JWT)

6. cURL examples

Set module variables:

export DOMAIN_NAME="brand.example"

DC-01 Create BYOD domain

curl -sS -X POST "${API_BASE}/v2/account/domains" \
  -H "authorization: Bearer ${JWT_TOKEN}" \
  -H 'content-type: application/json' \
  -d '{"domain":"'"${DOMAIN_NAME}"'","sourceType":"BYOD_HOSTNAME"}'

DC-02 Reconcile domain

curl -sS -X POST "${API_BASE}/v2/account/domains/${DOMAIN_NAME}/reconcile" \
  -H "authorization: Bearer ${JWT_TOKEN}" \
  -H 'content-type: application/json' \
  -d '{}'

DC-03 Read domain state

curl -sS "${API_BASE}/v2/account/domains/${DOMAIN_NAME}" \
  -H "authorization: Bearer ${JWT_TOKEN}"

DC-04 Update domain routes

curl -sS -X PUT "${API_BASE}/v2/account/domains/${DOMAIN_NAME}/routes" \
  -H "authorization: Bearer ${JWT_TOKEN}" \
  -H 'content-type: application/json' \
  -d '{
    "defaultHandle":"'"${HANDLE}"'",
    "pathRules":[{"pathPrefix":"/shop","handle":"'"${HANDLE}"'","priority":10}]
  }'

7. Expected success outputs and verification checks

• Domain create returns 201 and pending lifecycle state.
• Reconcile returns 202 with async workflow acknowledgment.
• Domain read shows lifecycle progression.
• Route update returns 200 and route map persistence confirmation.

8. Failure modes and remediation

• 403 on account-domain writes:
• Remediation: use tenant-owner JWT.
• 404 for domain after create:
• Remediation: verify exact domain string and account ownership context.
• Reconcile remains pending too long:
• Remediation: verify DNS prerequisites and propagation before retry.

9. Async behavior notes

• Domain reconcile and purchase paths are handled via asynchronous processing.
• Host-route updates can trigger background sync steps.

10. Related links

• Playbooks escalation boundaries ([Platform Admin] approvals/overrides)
• Lifecycle Messaging + Retargeting
• Creator Revenue