Skip to main content
GET
Error

Authorizations

Authorization
string
header
required

A merchant secret key (sk_…) sent as Authorization: Bearer <key>.

Path Parameters

id
string
required

The payment link id (pl_…).

Response

The payment link.

id
string
required

Payment link identifier (pl_…).

object
enum<string>
required
Available options:
payment_link
merchant_id
string
required
livemode
boolean
required

True for live-mode links; false for test-mode.

active
boolean
required

False when deactivated; the hosted checkout shows an inactive state.

name
string
required
description
string | null
required
url
string
required

The public checkout URL (https://buy.ionicfi.com/c/…).

currency
string
required

Three-letter ISO currency code.

amount_total
integer
required

Total in minor units.

line_items
object[]
required
collect_config
object
required

Specifies which contact fields to collect at checkout and how.

submit_type
enum<string> | null
required
Available options:
pay,
book,
donate
Available options:
one_time,
subscription,
invoice
theme_id
string | null
required
success_url
string | null
required
cancel_url
string | null
required
inactive_message
string | null
required
metadata
object
required
created_at
integer
required

Unix epoch seconds.

updated_at
integer
required
optional_items
object[]

Omitted when the link has no optional add-ons.

custom_fields
object[]

Omitted when the link has no custom fields.

branding
object | null

Omitted when no branding overrides are set.

payment_intent_data
object | null

Omitted when no payment-intent overrides are set.