# Tribridge

> Accept Solana, Sui, and TON crypto payments with one API. Automatic settlement, real-time webhooks, and a 5-minute integration.

> ## 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](https://docs.tribridge.xyz/introduction.md): Accept crypto payments globally, run any pricing model, and settle in your wallet — without building payment infrastructure.
- [Initial Setup](https://docs.tribridge.xyz/setup.md): Create your merchant account, get API keys, and run your first test payment in about 5 minutes.
- [API Keys](https://docs.tribridge.xyz/api-keys.md): One keypair for test and live mode, plus per-endpoint webhook signing secrets.
- [Authentication](https://docs.tribridge.xyz/authentication.md): Authenticate server-side requests with your API key and verify inbound webhooks with HMAC signatures.
- [Chains & Networks](https://docs.tribridge.xyz/chains.md): Solana and Sui are live on mainnet today. TON is coming soon. One API for all of them.
- [Architecture](https://docs.tribridge.xyz/architecture.md): How Tribridge turns a customer wallet transfer into settled funds: address factory, detection, relayer forwarding.
- [Payment Lifecycle](https://docs.tribridge.xyz/lifecycle.md): Every payment state from pending to completed, what triggers it, and what you should do.
- [Creating Payments](https://docs.tribridge.xyz/payments.md): Create payment requests with POST /payments and track them from pending to completed.
- [Payouts](https://docs.tribridge.xyz/payouts.md): Withdraw your settled balance to a linked wallet, confirmed with a one-time email code.
- [Refunds](https://docs.tribridge.xyz/refunds.md): Automatic on-chain refunds for underpaid and overpaid payments — same asset, gas paid by Tribridge.
- [Webhooks](https://docs.tribridge.xyz/webhooks.md): Real-time POST notifications for every payment state change, signed with HMAC-SHA256.
- [SDKs & Libraries](https://docs.tribridge.xyz/sdks.md): Official Tribridge SDKs for JavaScript and PHP are coming soon. The REST API works today.
- [Testing](https://docs.tribridge.xyz/testing.md): Validate your full integration with simulated test mode — no real funds, no chain waits.
- [Errors](https://docs.tribridge.xyz/errors.md): HTTP status codes, amount-mismatch events, and how to build a resilient integration.


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