Skip to main content
GET
GET /payment-link/{id} returns one of your payment links. Poll it to see whether a link has been paid: status is active, used, expired, or cancelled, and usesCount is the number of successful payments taken through it. A link that belongs to another merchant, or to the other environment, returns 404.

​
Example

Payments made through a link are ordinary payments: they send the usual payment webhooks, and the link’s reference is their orderCode.

Authorizations

​
Authorization
string
header
required

Your secret API key: Bearer prv_production_xxx (production) or Bearer prv_sandbox_xxx (sandbox).

Path Parameters

​
id
string<uuid>
required

The payment link id.

Query Parameters

​
merchantCode
string

Your merchant account identifier. Required if the key maps to more than one merchant account.

Response

The payment link

​
id
string<uuid>
​
url
string<uri>

The hosted checkout URL to share with the payer.

​
type
enum<string>
Available options:
one-time,
subscription
​
status
enum<string>

used once a single-use link takes its first successful payment, or a reusable link reaches maxUses.

Available options:
active,
used,
expired,
cancelled
​
amountMode
enum<string>
Available options:
fixed,
customer_entered
​
amount
object

Absent on subscription links. For customer_entered links only currency and exponent are set.

​
amountMin
integer<int64>

Minimum payer-entered amount, minor units.

​
amountMax
integer<int64>

Maximum payer-entered amount, minor units.

​
subscriptionPlanId
integer<int64>
​
checkoutConfigId
string<uuid>
​
title
string
​
description
string
​
reference
string
​
customerEmail
string
​
customerName
string
​
returnUrl
string<uri>
​
saveCardEnabled
boolean
​
reusable
boolean
​
maxUses
integer
​
usesCount
integer

Number of successful payments taken through this link.

​
environment
enum<string>
Available options:
production,
sandbox
​
expiresAt
string<date-time>
​
usedAt
string<date-time>
​
createdAt
string<date-time>