Initial Setup

Prerequisites

A Tribridge merchant account (free, created below).
A server or backend that can make HTTPS requests and keep secrets (API keys must never live in frontend code).
An HTTPS endpoint of your own if you want to receive webhooks (for local development, a tunnel like ngrok works).

Create an account

Sign up at tribridge.tech/signup and verify your email. This unlocks the merchant dashboard.Then add a payout wallet for each chain you want to accept — this is the destination address where your settled funds are paid out. Your payout wallet remains a destination only you control.

Generate your API keypair

In the dashboard, open API Keys and generate a keypair. You receive two keys at once, each shown exactly once:

Key	Prefix	What it does
Test key	`tri_test_...`	Simulated payments. No real funds move. Build and validate webhooks with this.
Live key	`tri_live_...`	Real on-chain payments on mainnet. Switch to this only after test mode works.

Save both somewhere safe — a secrets manager or environment variables, never in git:

.env

TRIBRIDGE_TEST_KEY=tri_test_your_key_here
TRIBRIDGE_LIVE_KEY=tri_live_your_key_here

Create your first test payment

Call POST /payments with your test key. A success response contains a checkout_url:

cURL

curl -X POST https://tribridge.onrender.com/payments \
  -H "Content-Type: application/json" \
  -H "x-api-key: tri_test_your_key_here" \
  -d '{
    "amount": 25.00,
    "currency": "USD",
    "redirect_url": "https://yoursite.com/success"
  }'

Open the returned checkout_url (it looks like https://tribridge.onrender.com/gateway?payment_id=...), pick a chain, and click the Simulate Payment button — test mode only. The payment drives straight to completed and Tribridge fires your test webhook, exactly like a live payment would.

Go live

Once your webhook handler verifies correctly in test mode:

Swap tri_test_... for tri_live_... in your server config.
Register a live webhook endpoint (POST /webhooks with is_test: false).
Accept your first real payment.

No code changes beyond the key swap are needed.

Next steps

Creating Payments

Full reference for POST /payments — headers, fields, and responses.

Get Started

Core Concepts

Prerequisites

Next steps

Creating Payments

Webhooks

​Prerequisites

​Next steps

Creating Payments

Webhooks

Prerequisites

Next steps