Getting Started

Use this path to validate access and the published fail-closed Partner API contract. There is no successful estimate, RFQ, or order operation yet.

---

1. Request approved access

Contact info@nowtoprint.com with:

• company name and website
• integration use case
• expected volume or rollout stage
• whether you need webhook, XJDF, or private-beta partner onboarding

---

2. Create a sandbox key

After approval, generate a sandbox credential in the partner portal Developer area.

Environment	Prefix	Base URL
Sandbox	ntp_test_*	https://api.nowtoprint.com/api/v1
Live	ntp_live_*	https://api.nowtoprint.com/api/v1

Use sandbox first. Live credentials are registry/private-beta controls for approved workflows; they do not turn on public GA traffic, RFQ creation, quote automation, order automation, webhooks, or Master Data data-product access by themselves.

---

3. Import the contract

Start from the published OpenAPI file:

• /docs/api/openapi.yaml

Import that URL into Postman, Bruno, or Insomnia before writing production code. It keeps payloads, examples, and expected responses aligned with the public contract.

---

4. Send a first request

Use an estimate request to validate auth and environment wiring:

curl -X POST https://api.nowtoprint.com/api/v1/estimate \
  -H "Authorization: Bearer ntp_test_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "flyer",
    "quantity": 1000
  }'

With valid auth and estimate:read, expect RFC 9457 503 with PARTNER_ESTIMATE_CAPABILITY_UNAVAILABLE. The body is not parsed and no estimate is produced. RFQ and order routes follow the same fail-closed pattern with capability-specific codes.

---

5. Prepare for an approved rollout

Before any approved live workflow:

• rotate away any shared onboarding keys
• store the live key in managed secrets
• implement webhook verification only for webhook-enabled pilots
• log request IDs and honor Retry-After
• test idempotent retry handling on any enabled write operation
• confirm that required routes are present in /docs/api/openapi.yaml

---

Next steps