Hilt

Hilt Hilt Pay API

The Hilt Pay API API from Hilt — 39 operation(s) for hilt pay api.

GitHub OpenAPI

Operations 39

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v1/agent-commerce/offer Get the Hilt Pay API marketplace offer · Get the Hilt Pay API marketplace catalog #
Ask an LLM
“What plans does the Hilt Pay API marketplace offer and how can I buy them?”
“Is there a free Agent Bootstrap route listed alongside the paid plans?”
Tell an agent
Show me the Hilt Pay API marketplace offer.
List the live purchase paths for the API plans.
GET /v1/agent-commerce/catalog Get the agent-commerce catalog · Get the canonical Hilt agent-commerce catalog #
Ask an LLM
“What products and tools are in the canonical agent-commerce catalog?”
“Where can an agent read the full list of things it can buy from Hilt?”
Tell an agent
Fetch the agent-commerce catalog.
Show everything in the canonical agent catalog.
GET /v1/agent-commerce/pricing Get agent-commerce pricing · Get canonical Hilt agent-commerce pricing #
Ask an LLM
“How much do the Starter, Growth and Scale plans cost?”
“What are the canonical USDC prices for agent purchases?”
Tell an agent
Show the agent-commerce pricing.
Get the current price list for the API plans.
POST /v1/agent-commerce/plans/starter/activate Buy the Starter plan with x402 · Activate Hilt Pay API Starter #
Ask an LLM
“Can my agent pay 79 USDC over x402 to activate the Starter plan?”
“What does it take to buy 30 days of Starter and receive a live key?”
Tell an agent
Activate Starter for setup intent {setup_intent_id} with token {setup_token} and claim {delivery_claim}.
Pay 79 USDC via x402 for the Starter plan on setup intent {setup_intent_id}.
POST /v1/agent-commerce/plans/growth/activate Buy the Growth plan with x402 · Activate Hilt Pay API Growth #
Ask an LLM
“Can an agent pay 349 USDC through x402 to activate the Growth plan?”
“What do I send to buy 30 days of Growth tier and get a live API key?”
Tell an agent
Activate Growth for setup intent {setup_intent_id} with token {setup_token} and claim {delivery_claim}.
Pay 349 USDC via x402 for the Growth plan on setup intent {setup_intent_id}.
POST /v1/agent-commerce/plans/scale/activate Buy the Scale plan with x402 · Activate Hilt Pay API Scale #
Ask an LLM
“Can I pay 1250 USDC with x402 to unlock the Scale plan?”
“What's needed to activate 30 days of the top Scale tier?”
Tell an agent
Activate Scale for setup intent {setup_intent_id} with token {setup_token} and claim {delivery_claim}.
Pay 1250 USDC via x402 for the Scale plan on setup intent {setup_intent_id}.
POST /v1/agent-commerce/plans/claim Recover a live key after a marketplace purchase · Claim a live Hilt Pay API key after marketplace activation #
Ask an LLM
“I paid for a plan but never got the key - can I claim it again?”
“What do I need to recover a live key after a settled marketplace payment?”
Tell an agent
Claim the live key for purchase {purchase_intent_id} using setup intent {setup_intent_id}, token {setup_token} and claim {delivery_claim}.
Recover my key from purchase {purchase_intent_id}.
POST /v1/access/agent-bootstrap Create a sandbox setup intent for an agent · Create a sandbox Hilt Pay API setup intent for an agent #
Ask an LLM
“How does an agent get started with a free sandbox setup intent?”
“Can I request specific permissions when bootstrapping an agent?”
Tell an agent
Create a bootstrap setup intent for agent {agent_name}.
Bootstrap agent {agent_name} on {agent_platform} for use case {requested_use_case}.
POST /v1/access/agent-bootstrap/{setup_intent_id}/status Check an agent setup intent's status · Check a Hilt Pay API agent setup intent #
Ask an LLM
“Has my agent's setup intent been approved yet?”
“Where can I poll the status of an Agent Bootstrap intent?”
Tell an agent
Check status of setup intent {setup_intent_id} with token {setup_token}.
Tell me whether bootstrap intent {setup_intent_id} is ready.
POST /v1/access/agent-bootstrap/{setup_intent_id}/manifest Submit an agent setup manifest for evaluation · Attach and evaluate an agent setup manifest #
Ask an LLM
“Can I attach a manifest describing my agent to its setup intent?”
“How is an agent's setup manifest evaluated?”
Tell an agent
Attach manifest {manifest} to setup intent {setup_intent_id} with token {setup_token}.
Submit my agent manifest for intent {setup_intent_id}.
POST /v1/access/agent-bootstrap/{setup_intent_id}/approve Approve an agent setup intent · Approve an agent setup intent and optionally issue a live Hilt Pay API key #
Ask an LLM
“As the owner, how do I approve an agent's setup request?”
“Can approving an agent also issue it a live key?”
Tell an agent
Approve setup intent {setup_intent_id} with token {setup_token}.
Approve intent {setup_intent_id} and issue a live key named {live_key_name}.
GET /v1/access/rails List supported payment rails · List Hilt Pay API rails #
Ask an LLM
“Which payment rails does the Hilt Pay API support?”
“What settlement options can products be paid through?”
Tell an agent
List the available payment rails.
Show all supported rails.
GET /v1/access/rail-settings List my rail settings · List merchant Hilt Pay API rail settings #
Ask an LLM
“Which rails have I enabled and where do they pay out?”
“Can I see my current configuration for each payment rail?”
Tell an agent
Show my rail settings.
List how each of my rails is configured.
PUT /v1/access/rail-settings/{rail_id} Configure a payment rail · Configure a merchant Hilt Pay API rail #
Ask an LLM
“How do I set the payout address for one of my rails?”
“Can I switch a rail off or change how fees are collected on it?”
Tell an agent
Enable rail {rail_id} with payout address {payout_address}, key {idem}.
Set rail {rail_id} enabled to {enabled} using idempotency key {idem}.
GET /v1/access/native-subscriptions/{authorization_id} Read a Solana native subscription authorization · Read a Solana native subscription authorization #
Ask an LLM
“Can I look up a buyer's on-chain subscription authorization?”
“What's the state of a native Solana subscription?”
Tell an agent
Show native subscription {authorization_id}.
Read the authorization details for {authorization_id}.
POST /v1/access/native-subscriptions/{authorization_id}/cancel-intent Start a buyer's native subscription cancellation · Create a buyer cancellation intent #
Ask an LLM
“How does a buyer begin cancelling a native Solana subscription?”
“Can the cancellation take effect at the end of the current period?”
Tell an agent destructive · confirm first
Create a cancellation intent for subscription {authorization_id}.
Start cancelling {authorization_id} at period end for reason {reason}.
POST /v1/access/native-subscriptions/{authorization_id}/cancel-confirm Confirm a native subscription cancellation · Confirm native subscription cancellation proof #
Ask an LLM
“Where do I submit the on-chain cancel transaction to finish cancelling a subscription?”
“Can cancellation be verified on-chain and the authority revoked right away?”
Tell an agent destructive · confirm first
Confirm cancellation of {authorization_id} with transaction {cancel_tx_signature}, key {idem}.
Finalize cancel of {authorization_id} with revoke signature {revoke_tx_signature}, key {idem}.
POST /v1/access/apps Create a Hilt Pay API app · Create a Hilt Pay API app #
Ask an LLM
“How do I register an app to group my paid API products?”
“Can I set a default payment rail when creating an app?”
Tell an agent
Create an access app named {name} with idempotency key {idem}.
Create app {name} using default rail {default_rail}, key {idem}.
POST /v1/access/products Create a paid API access product · Create a Hilt Pay API product #
Ask an LLM
“Can I sell metered or subscription access to my API as a product?”
“What billing models can an access product use?”
Tell an agent
Create an access product {title} priced at {amount_minor_units}, key {idem}.
Create an access product under app {access_app_id} with billing model {billing_model}, key {idem}.
GET /v1/access/setup/readiness Check Hilt Pay API setup readiness · Inspect agent setup readiness for Hilt Pay API #
Ask an LLM
“Is my app or product fully set up to start accepting agent payments?”
“What setup steps are still missing before going live?”
Tell an agent
Check setup readiness for product {product_id}.
Inspect readiness of app {access_app_id} in {mode} mode.
GET /v1/access/products/available-rails Look up a product's rails by external ID · List available rails for a Hilt Pay API product by lookup #
Ask an LLM
“Which rails can pay for a product I only know by my own external ID?”
“Can I find available rails without the Hilt product ID?”
Tell an agent
List rails available for external product {external_product_id}.
Look up payable rails for external product {external_product_id} in {mode} mode.
GET /v1/access/products/{product_id}/available-rails List rails available for a product · List available rails for a Hilt Pay API product #
Ask an LLM
“Which payment rails are enabled for this specific product ID?”
“Can buyers pay this product on more than one rail?”
Tell an agent
List available rails for product {product_id}.
Show which rails product {product_id} accepts in {mode} mode.
POST /v1/access/payment-sessions Create a payment session for an access product · Create an access payment session #
Ask an LLM
“How do I start a live payment session for a customer buying API access?”
“Can I pick the rail and payment protocol for a payment session?”
Tell an agent
Create a payment session for product {product_id} and customer {external_customer_id}, key {idem}.
Open a live payment session on rail {rail} for product {product_id}, key {idem}.
POST /v1/access/metered-sessions Open an MPP metered payment session · Create an MPP metered payment session #
Ask an LLM
“Can I charge a customer per unit with a spending cap using MPP?”
“What sets the maximum a metered session can spend?”
Tell an agent
Open a metered session for customer {external_customer_id} capped at {cap_minor_units}, key {idem}.
Create an MPP metered session on product {product_id} for {external_customer_id} with cap {cap_minor_units}, key {idem}.
POST /v1/access/metered-sessions/{session_id}/authorize Authorize actions on an MPP metered session · Open, update, commit, or close an MPP metered session #
Ask an LLM
“How does a payer open, top up, commit or close a metered session?”
“Where does the MPP payment authorization for a metered session go?”
Tell an agent
Authorize metered session {session_id}.
Send payment credential {authorization} to metered session {session_id}.
POST /v1/access/metered-sessions/{session_id}/deliveries Reserve a metered delivery on an MPP session · Reserve metered delivery against an open MPP session #
Ask an LLM
“Can I reserve units against an open metered session before delivering them?”
“How long does a delivery reservation hold?”
Tell an agent
Reserve {units} units on metered session {session_id}, key {idem}.
Reserve delivery {delivery_id} on session {session_id} for {ttl_seconds} seconds, key {idem}.
POST /v1/access/metered-sessions/{session_id}/commits Commit a reserved metered delivery · Commit a reserved delivery with its cumulative MPP voucher #
Ask an LLM
“How do I commit a reserved delivery with the payer's cumulative voucher?”
“What finalizes a delivery I reserved on a metered session?”
Tell an agent
Commit delivery {deliveryId} on session {session_id} with voucher {voucher}.
Finalize reserved delivery {deliveryId} for metered session {session_id}.
POST /v1/access/metered-sessions/{session_id}/settle Settle an MPP metered session · Settle an open MPP session at its highest verified voucher #
Ask an LLM
“When I'm done metering, how do I collect payment for the session?”
“Does settling use the highest verified voucher?”
Tell an agent
Settle metered session {session_id} with idempotency key {idem}.
Collect payment on session {session_id} at its highest voucher, key {idem}.
GET /v1/access/metered-sessions/{session_id} Read an MPP metered session · Read an MPP metered session and its delivery evidence #
Ask an LLM
“What has been delivered and paid on a metered session so far?”
“Can I see the delivery evidence for a metered session?”
Tell an agent
Show metered session {session_id}.
Get delivery evidence for metered session {session_id}.
POST /v1/access/sandbox/payment-sessions Create a sandbox payment session · Create a sandbox Hilt Pay API payment session #
Ask an LLM
“Can I test the payment session flow without moving real money?”
“How long does a sandbox payment session stay open?”
Tell an agent
Create a sandbox payment session for product {product_id}, key {idem}.
Open a test payment session for {email} lasting {ttl_minutes} minutes, key {idem}.
POST /v1/access/sandbox/payment-sessions/{sandbox_session_id}/confirm Confirm a sandbox payment proof · Confirm a sandbox Hilt Pay API payment proof #
Ask an LLM
“How do I complete a sandbox payment session with a test proof?”
“Can I simulate a successful payment in the sandbox?”
Tell an agent
Confirm sandbox session {sandbox_session_id} with proof {proof}, key {idem}.
Mark sandbox payment {sandbox_session_id} as paid using proof {proof}, key {idem}.
POST /v1/access/payment-proofs Submit a live rail payment proof · Submit a Hilt Pay API rail payment proof #
Ask an LLM
“Where do I send proof that a customer paid on a rail?”
“Can a payment proof be tied to an existing payment session?”
Tell an agent
Submit payment proof {proof_payload} with idempotency key {idem}.
Submit proof {proof_payload} for payment session {payment_session_id}, key {idem}.
POST /v1/access/x402/settle Verify and settle an x402 payment · Verify and settle an x402 V2 payment #
Ask an LLM
“How do I verify and settle an x402 V2 payment signature?”
“Which payment session does an x402 settlement apply to?”
Tell an agent
Settle the x402 payment for session {payment_session_id}, key {idem}.
Verify x402 signature {payment_signature} for session {payment_session_id}, key {idem}.
POST /v1/access/entitlements/check Check a customer's access entitlement · Check access entitlement #
Ask an LLM
“Does this customer currently have paid access to my product?”
“Can I check access by wallet or email instead of customer ID?”
Tell an agent
Check whether customer {external_customer_id} has access to product {product_id}.
Check entitlement for wallet {wallet} on product {product_id}.
POST /v1/access/entitlements/consume Consume metered entitlement usage · Atomically consume metered entitlement usage #
Ask an LLM
“How do I deduct usage units from a customer's entitlement?”
“Is usage consumption atomic so I don't double-count?”
Tell an agent
Consume {units} units for customer {external_customer_id} on product {product_id}, key {idem}.
Deduct {units} units from wallet {wallet}'s entitlement, key {idem}.
GET /v1/access/entitlements/{entitlement_id} Get an access entitlement · Get an access entitlement #
Ask an LLM
“Can I look up one entitlement by its ID?”
“What are the details and remaining usage of an entitlement?”
Tell an agent
Get entitlement {entitlement_id}.
Show details of entitlement {entitlement_id}.
GET /v1/access/billing/entitlement Get my Hilt Pay API plan entitlement · Get current Hilt Pay API billing entitlement #
Ask an LLM
“Which Hilt Pay API plan am I entitled to right now?”
“When does my current API plan entitlement expire?”
Tell an agent
Show my current Hilt Pay API billing entitlement.
Check which API plan I'm entitled to.
POST /v1/access/billing/checkout/stripe Use the retired API subscription checkout · Retired Hilt Pay API subscription checkout #
Ask an LLM
“Is the old Stripe checkout for Hilt Pay API subscriptions still available?”
“What happens if I call the retired API plan card checkout?”
Tell an agent
Call the retired Hilt Pay API Stripe checkout for plan {plan} with {success_url} and {cancel_url}.
Try the legacy API-plan card checkout for {plan}, returning to {success_url} or {cancel_url}.
POST /v1/access/webhooks Create a Hilt Pay API webhook endpoint · Create a webhook endpoint for Hilt Pay API #
Ask an LLM
“Can I get webhooks for access payments and entitlements?”
“How do I scope a Hilt Pay API webhook to certain access products?”
Tell an agent
Create a Hilt Pay API webhook {label} at {url}, key {idem}.
Add an access webhook {label} to {url} for events {subscribed_events}, key {idem}.

Documentation

📖
Documentation
https://docs.hilt.so/developers
📖
APIReference
https://api.hilt.so/v1/docs
📖
APIReference
https://api.hilt.so/v1/redoc
📖
GettingStarted
https://docs.hilt.so/developers/quickstart
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/hilt-so/refs/heads/main/authentication/hilt-so-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/hilt-so/refs/heads/main/rate-limits/hilt-so-rate-limits.yml
📖
Documentation
https://docs.hilt.so/developers/transaction-evidence

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/hilt-so/refs/heads/main/openapi/hilt-so-hilt-pay-api-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/hilt-so/refs/heads/main/asyncapi/hilt-so-webhooks-asyncapi.yml

Other Resources

🔗
OAuthScopes
https://raw.githubusercontent.com/api-evangelist/hilt-so/refs/heads/main/scopes/hilt-so-scopes.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/hilt-so/refs/heads/main/conventions/hilt-so-conventions.yml
🔗
Idempotency
https://raw.githubusercontent.com/api-evangelist/hilt-so/refs/heads/main/conventions/hilt-so-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/hilt-so/refs/heads/main/errors/hilt-so-problem-types.yml
🔗
Conformance
https://raw.githubusercontent.com/api-evangelist/hilt-so/refs/heads/main/conformance/hilt-so-conformance.yml
🔗
Lifecycle
https://raw.githubusercontent.com/api-evangelist/hilt-so/refs/heads/main/lifecycle/hilt-so-lifecycle.yml
🔗
Sandbox
https://raw.githubusercontent.com/api-evangelist/hilt-so/refs/heads/main/sandbox/hilt-so-sandbox.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/hilt-so/refs/heads/main/data-model/hilt-so-data-model.yml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/hilt-so/refs/heads/main/asyncapi/hilt-so-webhooks-asyncapi.yml
🔗
Webhooks
https://docs.hilt.so/developers/webhooks
🔗
Plans
https://raw.githubusercontent.com/api-evangelist/hilt-so/refs/heads/main/plans/hilt-so-plans-pricing.yml
🔗
ChangeLog
https://raw.githubusercontent.com/api-evangelist/hilt-so/refs/heads/main/changelog/hilt-so-changelog.yml
🔗
Postman
https://www.hilt.so/downloads/hilt-postman-collection-latest.json
🔗
Postman
https://raw.githubusercontent.com/api-evangelist/hilt-so/refs/heads/main/postman/hilt-so-postman-collection.json
🔗
Packages
https://raw.githubusercontent.com/api-evangelist/hilt-so/refs/heads/main/packages/hilt-so-packages.yml
🔗
SDKs
https://raw.githubusercontent.com/api-evangelist/hilt-so/refs/heads/main/packages/hilt-so-packages.yml
🔗
CLI
https://raw.githubusercontent.com/api-evangelist/hilt-so/refs/heads/main/cli/hilt-so-cli.yml
🔗
Components
https://raw.githubusercontent.com/api-evangelist/hilt-so/refs/heads/main/components/hilt-so-components.yml
🔗
ToolCrosswalk
https://raw.githubusercontent.com/api-evangelist/hilt-so/refs/heads/main/mcp/hilt-so-tool-crosswalk.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/hilt-so:hilt-so-hilt-pay-api-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

hilt-so-hilt-pay-api-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Hilt Pay API
  description: Hilt Pay Workspace and Hilt Pay API routes for zero-custody Solana checkout, MPP metered payment channels, receipts, memberships, entitlements, native subscriptions, webhooks, and support context.
  version: 1.0.0
  contact:
    name: Hilt
    url: https://www.hilt.so
    email: hello@hilt.so
  x-guidance: Start with POST /v1/access/agent-bootstrap. An agent can purchase 30 days of Starter, Growth, or Scale through the matching x402 V2 activation endpoint paid in Solana USDC. For metered integrations, settle PAYMENT-SIGNATURE through POST /v1/access/x402/settle and atomically consume through POST /v1/access/entitlements/consume before serving. Never send private keys, seed phrases, or wallet secrets.
servers:
- url: https://api.hilt.so
tags:


# --- truncated at 32 KB (146 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/hilt-so/refs/heads/main/openapi/hilt-so-hilt-pay-api-api-openapi.yml