SDKs and Postman

Use this page when you want the fastest copy-paste path after Developer quickstart. Hilt now publishes official public developer assets for the supported merchant contract:

TypeScript SDK
Python SDK
Postman collection
Postman environment

These stay aligned with the same public merchant routes documented elsewhere in Hilt docs:

products
hosted checkout
payments
memberships
receipts
support
webhooks

30-second SDK proof

If you only want to prove the published SDKs install and can talk to Hilt, use one of these smallest possible reads.

TypeScript

import { HiltClient } from "@hiltpay/sdk";

const client = new HiltClient({ apiKey: process.env.HILT_API_KEY! });
const products = await client.products.list();

console.log(products);

Python

import os
from hilt_sdk import HiltClient

client = HiltClient(api_key=os.environ["HILT_API_KEY"])
print(client.products.list())

Success looks like:

the package installs cleanly
auth works
the SDK returns the same products your workspace sees in Hilt

Representative output:

[
  {
    "id": "ae9673c8-95db-4b39-bc2c-b5e6d5dfd9d3",
    "slug": "example-slug",
    "title": "Hilt Quickstart Access",
    "status": "ACTIVE"
  }
]

Node `.env.local`

HILT_API_KEY=hk_live_...
HILT_MERCHANT_WALLET=So1anaMerchantWallet1111111111111111111111111

Python `.env`

HILT_API_KEY=hk_live_...
HILT_MERCHANT_WALLET=So1anaMerchantWallet1111111111111111111111111

TypeScript quickstart

Install

npm install @hiltpay/sdk

Source and releases:

npm: https://www.npmjs.com/package/@hiltpay/sdk
GitHub: https://github.com/Hiltpay/hilt-sdk-js

Copy-paste example

import { HiltClient } from "@hiltpay/sdk";

const client = new HiltClient({
  apiKey: process.env.HILT_API_KEY!,
});

const product = await client.products.create({
  product_type: "PAYMENT_LINK",
  title: "SDK quickstart access",
  description: "Manual recurring access from the TypeScript SDK",
  amount_minor_units: 29000000,
  token_mint: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  merchant_wallet: process.env.HILT_MERCHANT_WALLET!,
  delivery_type: "REDIRECT",
  delivery_value: "https://example.com/hilt/thanks",
  membership_config: {
    enabled: true,
    platform: "CUSTOM",
    identity_type: "WALLET",
    identity_required: false,
    renewal_mode: "MANUAL",
    billing_interval_days: 30,
    grace_period_days: 3,
  },
});

const checkout = await client.checkout.getProduct(product.slug);

console.log({
  productId: product.id,
  slug: product.slug,
  title: checkout.title,
});

Expected result:

one active product in Hilt
one reusable product.id
one reusable slug
one buyer-facing checkout payload you can compare against the dashboard

Python quickstart

Install

pip install hilt-sdk

Source and releases:

PyPI: https://pypi.org/project/hilt-sdk/
GitHub: https://github.com/Hiltpay/hilt-sdk-python

Copy-paste example

import os
from hilt_sdk import HiltClient

client = HiltClient(api_key=os.environ["HILT_API_KEY"])

product = client.products.create(
    {
        "product_type": "PAYMENT_LINK",
        "title": "Python quickstart access",
        "description": "Manual recurring access from the Python SDK",
        "amount_minor_units": 29000000,
        "token_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "merchant_wallet": os.environ["HILT_MERCHANT_WALLET"],
        "delivery_type": "REDIRECT",
        "delivery_value": "https://example.com/hilt/thanks",
        "membership_config": {
            "enabled": True,
            "platform": "CUSTOM",
            "identity_type": "WALLET",
            "identity_required": False,
            "renewal_mode": "MANUAL",
            "billing_interval_days": 30,
            "grace_period_days": 3,
        },
    }
)

receipts = client.receipts.list({"page": 1, "per_page": 5, "product_id": product["id"]})

print({
    "product_id": product["id"],
    "slug": product["slug"],
    "receipt_count": receipts["total"],
})

Expected result:

one product created from Python
one clean product["id"]
one repeatable receipts query for later proof handling

Postman quickstart

Use the public developer-assets repo for the mirrored machine-readable assets:

https://github.com/Hiltpay/hilt-developer-assets

Import:

postman/hilt-postman-collection.json
postman/hilt-postman-environment.json

Set these environment variables

The shipped environment already includes these keys:

baseUrl
apiKey
bearerToken
merchantWallet
productId
slug
paymentId
membershipId
receiptId
endpointId

Run these requests in order

Products -> Create product
Webhooks -> Create webhook endpoint
Webhooks -> Send test event
Testing -> Create sandbox session

What you should capture as you go:

productId
slug
endpointId
fake sandbox ids such as fake_payment_id and fake_receipt_id

Why Postman is useful here

Postman is the fastest way to verify:

your auth surfaces are correct
the public merchant contract matches the docs
webhook endpoint management works with a bearer token
sandbox responses match the object shapes your application expects

OpenAPI and fallback assets

The live Hilt contract surfaces are:

OpenAPI: https://api.hilt.so/v1/openapi.json
Swagger UI: https://api.hilt.so/v1/docs
Redoc: https://api.hilt.so/v1/redoc

If you want Hilt-hosted fallback imports instead of GitHub:

https://www.hilt.so/downloads/hilt-postman-collection-latest.json
https://www.hilt.so/downloads/hilt-postman-environment-latest.json

If you want Hilt-hosted package bundles instead of npm or PyPI:

https://www.hilt.so/downloads/hilt-sdk-latest.tgz
https://www.hilt.so/downloads/hilt_sdk-1.0.0-py3-none-any.whl
https://www.hilt.so/downloads/hilt-sdk-1.0.0.tar.gz

Auth surfaces

For most merchant requests in the SDKs and Postman collection, use:

X-Hilt-Key: hk_live_...

Webhook endpoint management currently requires a dashboard session token:

Authorization: Bearer JWT_TOKEN

That is why the webhook methods in the SDKs and the webhook requests in the Postman collection use the bearer-token surface instead of an API key.

What to do after the SDK quickstart

run a signed test webhook event
create one sandbox session
finish with one tiny live payment
verify payment, membership, receipt, and delivery state afterwards

For that exact flow, go back to Developer quickstart and Testing and going live.

Start here

Operations and proof

Examples and reference

SDKs and Postman

SDKs and Postman

30-second SDK proof

TypeScript

Python

Node `.env.local`

Python `.env`

TypeScript quickstart

Install

Copy-paste example

Python quickstart

Install

Copy-paste example

Postman quickstart

Set these environment variables

Run these requests in order

Why Postman is useful here

OpenAPI and fallback assets

Auth surfaces

What to do after the SDK quickstart

Start here

Operations and proof

Examples and reference

​SDKs and Postman

​30-second SDK proof

​TypeScript

​Python

​Node .env.local

​Python .env

​TypeScript quickstart

​Install

​Copy-paste example

​Python quickstart

​Install

​Copy-paste example

​Postman quickstart

​Set these environment variables

​Run these requests in order

​Why Postman is useful here

​OpenAPI and fallback assets

​Auth surfaces

​What to do after the SDK quickstart

SDKs and Postman

30-second SDK proof

TypeScript

Python

Node `.env.local`

Python `.env`

TypeScript quickstart

Install

Copy-paste example

Python quickstart

Install

Copy-paste example

Postman quickstart

Set these environment variables

Run these requests in order

Why Postman is useful here

OpenAPI and fallback assets

Auth surfaces

What to do after the SDK quickstart