Documentation

Payment Lifecycle

Follow the journey of a payment from creation to settlement in real-time.

Pending

A payment is created via POST /payments. TriBridge returns a unique id and a hosted checkout_url. No chain activity yet.

Address Generated

Your customer opens checkout and selects a chain (solana or sui). A one-time deposit wallet is derived and displayed.

Confirmed

The on-chain transfer reaches finality. TriBridge detects it and emits the payment.confirmed webhook.

Completed (Forwarded)

Funds are swept from the deposit wallet to your payout wallet. The payment.completed webhook fires and the customer is redirected.

Expired / Cancelled

Terminal states. A payment expires if unpaid past its window, or is cancelled manually from the dashboard.

Test mode shortcut

In test mode there is no real chain wait — the checkout page exposes a Simulate Payment button that drives the payment straight to completed and triggers your test webhook. Use it to validate your integration end-to-end.