---
title: "Get payment link details (public endpoint). Uses secure token for lookup."
method: GET
path: "/api/v1/payment-links/{token}/details"
tags: ["Payment Links"]
---

# Get payment link details (public endpoint). Uses secure token for lookup.

`GET /api/v1/payment-links/{token}/details`

Get payment link details (public endpoint). Uses secure token for lookup.

## Path parameters

- `token` string, required — The secure token from the payment link URL (64-char hex)

## Response `200`

Success

- PaymentLinkDetailsResponse
  - `success` boolean, required — Indicates if the request was successful
  - `data` object, required
    - `status` 'active' | 'used' | 'expired' | 'cancelled', required — Current status of the payment link
    - `link_type` 'single_use' | 'reusable', required — Payment link type
    - `merchant` object, required
      - `brand_name` string, required — Merchant brand name
      - `uri` string, required — Merchant URI identifier
      - `branding` object, nullable, required
        - `logo_url` string, nullable, required
        - `icon_url` string, nullable, required
        - `primary_color` string, nullable, required
        - `secondary_color` string, nullable, required
    - `partner_branding` object, nullable, required
      - `logo_url` string, nullable, required
      - `icon_url` string, nullable, required
      - `primary_color` string, nullable, required
      - `secondary_color` string, nullable, required
    - `order` object, required
      - `amount` string, required — Amount in minor units
      - `currency` string, required — Currency code (ISO 4217)
      - `payment_reference` string, required — Payment reference
    - `locale` string, required — Locale for the payment link
    - `allowed_countries` object[], required — Countries the customer can pay from
      - `code` string, required — Payer country code
      - `name` string, required — Country name
    - `default_customer_country` string, nullable, required — ISO 3166-1 alpha-2 country code

## Other responses

- `404` — Not Found

---

[API](https://skmtc.net/banqzinc/apis/quidkey-api.md) · [All operations](https://skmtc.net/banqzinc/apis/quidkey-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/banqzinc/quidkey-api/revisions/f86d2bdbcb08/schema)