Skip to main content
POST
Create a checkout from a payment link
Opens a payment link by creating a brand-new checkout session for it and returning the gateway URL to send the payer to. Each call mints an independent payment — call it once per payer.
checkout_url comes back relative (/gateway?payment_id=...) so links work on any host. Prepend your site origin before redirecting — e.g. https://tribridge.xyz + /gateway?payment_id=....

Request rules

The created payment inherits the link’s mode (is_test), currency, pinned chain + coin_symbol, description, and processing-fee flag — all configured on the link in your dashboard.

Response

201 Created
From there it’s the normal flow: Get checkout session for status, Verify payment for a manual re-check, and Webhooks for fulfillment.

Authorizations

x-api-key
string
header
required

Path Parameters

slug
string
required

Body

application/json
amount
number

Required when the link allows a custom amount; ignored for fixed-amount links. Minimum $0.50.

Required range: x >= 0.5
Example:

25

email
string<email>

Payer email, stored on the payment for receipts.

Example:

"jane@example.com"

name
string

Payer name.

Example:

"Jane Doe"

Response

Checkout session created from the link