Getting Started

Your Dashboard

Once your enterprise partner account is created, access your dashboard at Dashboard → Enterprise in x402 Studio. The enterprise dashboard gives you:

• Revenue overview — total revenue, your earnings, pending payouts, and endpoints deployed
• Enterprise URL — your branded landing page link to share with your agent ecosystem
• Transactions — full revenue ledger showing every payment with your share breakdown
• Webhooks — configure HTTPS webhook endpoints for payment and deployment events
• API Keys — generate enterprise API keys for programmatic access to the REST API and worker
• Settings — update branding, pricing, and payout wallets

Configure Pricing

From the Settings tab, you control:

Integrate via API

Your platform authenticates with the Singularity Enterprise API using API keys. This lets your backend list endpoints, query revenue, and identify your agents during endpoint creation.

Generate an API Key

1. Go to Enterprise Dashboard → API Keys
2. Click Create Key
3. Copy the key — it is only shown once

Use this key in the X-Enterprise-Key header on all API requests:

curl https://studio.x402layer.cc/api/v1/enterprise/endpoints \
  -H "X-Enterprise-Key: sgl_ent_your_key_here"

See the full API Reference for all available endpoints.

Connect Agents via MCP

For agent-native integration, your agents can connect to the Singularity MCP server directly:

When calling endpoint creation or topup tools, include:

{
  "enterprise_partner_slug": "your-slug"
}

Set Up Webhooks

1. Go to Dashboard → Enterprise → Webhooks
2. Click Add Webhook
3. Enter your HTTPS endpoint URL
4. Select which events to listen for
5. Store the signing secret securely — it is only shown once

Enterprise Webhook Events

Webhook Payload

{
  "event": "payment.succeeded",
  "source": "endpoint",
  "source_slug": "my-agent-endpoint",
  "amount": "1.00",
  "currency": "USDC",
  "tx_hash": "0xabc123...",
  "payer_wallet": "0x742d35Cc...",
  "network": "base",
  "status": "confirmed"
}

Verifying Signatures

Each webhook delivery includes an HMAC-SHA256 signature in the X-X402-Signature header. Compute HMAC(timestamp + "." + rawBody, secret) and compare.

For full verification details and code examples, see the Webhooks documentation.

Retry Policy

Webhooks are delivered once. If your endpoint returns a non-2xx status, the delivery is logged as failed but not retried. Monitor delivery logs in your enterprise dashboard under Webhooks > Delivery Logs to track success and failure.

Creating Endpoints via Enterprise

Agents on your platform create x402 endpoints by hitting the worker API with your enterprise key. This routes the payment through your program so revenue is split automatically.

Via REST API

POST https://api.x402layer.cc/agent/endpoints
X-Enterprise-Key: sgl_ent_your_key_here
Content-Type: application/json

{
  "name": "My Agent Endpoint",
  "base_url": "https://my-agent.com/api",
  "routes": [...]
}

The worker returns a 402 payment challenge. The agent signs the EIP-712 payload and resubmits with the X-Payment header. The endpoint is created at your configured deployment fee, and the revenue split applies immediately.

Via MCP

Agents connected to the Singularity MCP server include enterprise_partner_slug in the tool call to route through your program.

For full endpoint creation details (pricing, schema format, top-ups), see the Agentic Endpoints documentation.

Payout Wallets

Configure your payout addresses in Settings → Payout Wallets:

• Base wallet (required) — your EVM address on Base for USDC payouts
• Solana wallet (optional) — for Solana-chain payouts