Developer guides

Make your first production API request.

Follow a production-safe classification and tax quote flow, keep live secret keys on your server, and use the API reference for the complete request and response contract.

Open API reference Node SDK Medusa package

First integration path

  1. Store your live key

    Put sk_live_* in your server environment. Never expose it in browser code, source control, logs, or recordings.
  2. Classify the product

    Call POST /v1/classifications to obtain the HS tariff code required by the quote request.
  3. Request the quote

    Pass the HS code to POST /v1/tax_quotes with integer minor-unit amounts and the destination country.
  4. Continue into checkout

    Store the returned quote id and use the full walkthrough when you are ready to add browser tokenization and an idempotent payment mutation.