PaygateDeveloper documentation

Get Payment Link

GET/api/v1/payment-links/{id}
operationId
checkout.GetPaymentLink
Permission
paymentlink.read

Parameters

FieldinTypeRequiredDescription
idpathstringYes
PG-Versionheaderstring

Responses

200 OK

PaymentLink

Response headers: `X-Request-Id`

FieldTypeRequiredDescription
amountMoney
amount_typeenumValues: `fixed`, `open`
codestring
collect_emailenumValues: `required`, `optional`, `off`
collect_nameenumValues: `required`, `optional`, `off`
collect_phoneenumValues: `required`, `optional`, `off`
created_atstring (date-time) (date-time)
currencystring
descriptionstring
expires_atstring (date-time) (date-time)
idstring
max_amountMoney
max_usesinteger
metadataobject
min_amountMoney
modestring
numberstring
return_urlstring
statusenumValues: `active`, `disabled`
usesinteger
{
  "amount": {
    "currency": "string",
    "minor": 0
  },
  "amount_type": "fixed",
  "code": "string",
  "collect_email": "required",
  "collect_name": "required",
  "collect_phone": "required",
  "created_at": "2026-10-01T09:00:00Z",
  "currency": "string",
  "description": "string",
  "expires_at": "2026-10-01T09:00:00Z",
  "id": "string",
  "max_amount": {
    "currency": "string",
    "minor": 0
  },
  "max_uses": 0,
  "metadata": {},
  "min_amount": {
    "currency": "string",
    "minor": 0
  },
  "mode": "string",
  "number": "string",
  "return_url": "string",
  "status": "active",
  "uses": 0
}

default Error

Problem

FieldTypeRequiredDescription
codestringYes
detailstring
detailsobject
errorsobject[]
errors.codestring
errors.fieldstring
errors.messagestring
instancestring
statusintegerYes
titlestringYes
typestring
{
  "code": "string",
  "detail": "string",
  "details": {},
  "errors": [
    {
      "code": "string",
      "field": "string",
      "message": "string"
    }
  ],
  "instance": "string",
  "status": 0,
  "title": "string",
  "type": "string"
}

Errors

Derived from the modules this operation touches, because the snapshot carries no x-errors list yet — it may list codes this operation cannot return.

CodeStatus
checkout.bad_cursor400
checkout.link_not_found404
checkout.logo_not_found404
checkout.no_qr404
checkout.session_not_found404
checkout.link_unavailable409
checkout.amount_out_of_range422
checkout.invalid_branding422
checkout.invalid_payment_link422
checkout.return_url_not_allowed422

Try it

GET/payment-links/%7Bid%7D

Makes a real call in test mode with your own key. The key stays in this tab and is never sent anywhere but the API.

No API base URL is configured for this environment, so try-it is unavailable.

Starts with pg_test_. A live key is refused before any request is made.

curl -X GET '<API_BASE_URL>/api/v1/payment-links/%7Bid%7D' \
  -H 'Authorization: Bearer pg_test_…' \
  -H 'PG-Version: 2026-09-01'