> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tribridge.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Tribridge is a crypto payment gateway for Solana and Sui (TON is coming soon). API base URL is https://tribridge.onrender.com. Server-side calls authenticate with the x-api-key header using a tri_test_... key (fully simulated test mode, no real funds) or tri_live_... key (real mainnet payments) — never expose keys client-side. Merchant test mode is simulated, not testnet. Refunds are automatic only (underpaid/overpaid), there is no manual refund endpoint. Always verify webhook HMAC-SHA256 signatures from the X-Tribridge-Signature header before trusting payloads.

# Introduction

> Accept crypto payments globally, run any pricing model, and settle in your wallet — without building payment infrastructure.

Tribridge is the crypto payments platform for SaaS, AI, and digital businesses. Accept payments from customers anywhere, run one-time sales from the same catalog, and settle in your own wallet, all through one API and one dashboard.

## How it works in 30 seconds

<Steps>
  <Step title="Create a payment">
    Your server calls `POST /payments` with an amount and currency. Tribridge returns a payment `id` and a hosted `checkout_url`.
  </Step>

  <Step title="Customer pays">
    You send the customer to the `checkout_url`. They pick a chain (Solana or Sui) and pay from any wallet — Tribridge shows them a unique, one-time deposit address.
  </Step>

  <Step title="Tribridge confirms on-chain">
    Our detection engine watches the deposit address (Helius webhooks on Solana, an always-on listener on Sui) and confirms the transfer at finality.
  </Step>

  <Step title="You get paid">
    Confirmed funds are swept to the settlement vault and paid out to your linked payout wallet. Your webhook endpoint is notified at every step so your orders update in real time.
  </Step>
</Steps>

You never touch private keys, run a node, or write chain-specific code.

## What Tribridge handles

* **Unique deposit wallet per payment** — HD-derived, zero address reuse, zero collision risk.
* **On-chain monitoring** — Helius webhooks on Solana, polling listener on Sui.
* **Automatic settlement** — confirmed funds swept to your vault, then your payout wallet. Network gas is paid by Tribridge.
* **Automatic refunds** — underpayments are returned and overpayment surpluses sent back, same asset, no action needed from you.
* **Test mode** — simulate payments end-to-end with `tri_test_` keys before touching real money.

## Who is Tribridge for?

SaaS, AI tools, marketplaces, and digital stores that want to accept SOL, SUI, USDC, and USDT without running nodes or managing keys.

> You're a great fit if you're building a checkout, billing flow, or payment link and want to go live in an afternoon.

## Why Tribridge is different

<CardGroup cols={2}>
  <Card title="One API, every chain" icon="layers">
    Solana and Sui today — same create-payment call, chain chosen at checkout. TON is on the roadmap.
  </Card>

  <Card title="1% flat pricing" icon="badge-percent">
    No subscriptions, no setup fees. 1% per successful payment, minimum \$0.10. Failed payments are never charged.
  </Card>
</CardGroup>

## Quickstart

Create your first (test) payment with one command:

```bash cURL theme={null}
curl -X POST https://tribridge.onrender.com/payments \
  -H "x-api-key: tri_test_your_key" \
  -H "Content-Type: application/json" \
  -d '{"amount": 49, "currency": "USD"}'
```

You'll get back a `checkout_url` — open it, pick a chain, hit **Simulate Payment**, and watch your test webhook fire.

## Go live

Swap your test key for a `tri_live_` key, point a live webhook at production, and fund your vault. No code changes needed.

<Card title="Start here: Initial Setup" icon="rocket" href="/setup">
  Get your API keys and create your first payment in 5 minutes.
</Card>

<CardGroup cols={2}>
  <Card title="Create free account" icon="user-plus" href="https://tribridge.tech/signup">
    Sign up and get your test API keys.
  </Card>

  <Card title="Book a demo" icon="calendar" href="https://calendly.com/worgubelieve/30min">
    Talk to the team about your integration.
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Create free account" icon="rocket" href="https://tribridge.tech/signup" cta="Sign up free">
    1% per successful payment. No subscriptions, no setup fees.
  </Card>

  <Card title="Book a demo" icon="calendar" href="https://calendly.com/worgubelieve/30min" cta="Pick a time">
    30 minutes with the team — integration questions welcome.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.