Initial Setup

1. Create an Account

Sign up for a merchant account at tribridge.tech/signup. Verify your email to access the dashboard, then add a payout wallet for the chains you want to accept.

2. Obtain API Keys

Navigate to the API Keys section of your dashboard and generate a keypair. You'll receive a single pair — a tri_test_... key and a tri_live_... key — shown only once. Keep them in environment variables.

3. Test your integration

Create a payment with your test key. If the request succeeds you'll receive a checkout_url you can open to complete the flow in test mode.

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"
  }'

A successful response includes a checkout_url such as https://tribridge.onrender.com/gateway?payment_id=.... Open it, pick a chain, and use the Simulate Payment button (test mode only) to drive the payment to completion and trigger your webhook.

4. Go live

Once your webhooks verify correctly in test mode, swap tri_test_... for tri_live_..., register a live webhook endpoint, and you're ready to accept real payments.