Payments API

Create, manage, and track payment requests across any supported network.

POST/payments

Initialize a new payment request. TriBridge derives the merchant from your x-api-key header and returns a unique id plus a hosted checkout_url to send to your customer. The settlement chain is chosen later, when the deposit wallet is generated.

Headers

Header	Value
x-api-key	Your `tri_test_...` or `tri_live_...` key (required)
Content-Type	application/json

Body Parameters

Field	Type	Description
amount	number	The amount to charge (required).
currency	string	Fiat or token ticker, e.g. `USD`, `USDC`, `SOL` (required).
redirect_url	string	Where the customer is sent after the payment completes (optional).
description	string	A human-readable note shown on the checkout page (optional).

Note: the settlement chain (solana or sui) is selected when the deposit wallet is generated via POST /payments/checkout/:id/generate-wallet — it is not a field of the create request.

Example Request

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": 99.00,
    "currency": "USD",
    "redirect_url": "https://yoursite.com/order/8912",
    "description": "Order #8912"
  }'

Example Response

201 Created

{
  "id": "b3f1c2a0-1d4e-4f2a-9c8b-2e7a6f5d4c3b",
  "amount": "99.00",
  "currency": "USD",
  "status": "pending",
  "is_test": true,
  "redirect_url": "https://yoursite.com/order/8912",
  "checkout_url": "https://tribridge.onrender.com/gateway?payment_id=b3f1c2a0-1d4e-4f2a-9c8b-2e7a6f5d4c3b",
  "expires_at": "2026-08-25T12:30:00.000Z",
  "created_at": "2026-08-25T12:00:00.000Z"
}