> ## Documentation Index
> Fetch the complete documentation index at: https://docs.withgale.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Payment Link

> Retrieve details about a specific payment link

# Get Payment Link

Retrieve information about a payment link, including its current status and payment details.

## Authentication

```bash theme={null}
Authorization: Bearer glm_test_YOUR_API_KEY
```

## Path Parameters

| Parameter | Type | Required | Description |
| :- | :- | :- | :- |
| `id` | string | Yes | Payment link ID (e.g., `plink_abc123xyz`) |

## Response

> All monetary amounts are integers in cents (e.g., 4995 = \$49.95).

```json theme={null}
{
  "id": "plink_abc123xyz",
  "url": "https://checkout.withgale.com/pay/plink_abc123xyz",
  "amount": 4995,
  "currency": "USD",
  "description": "Premium Blood Pressure Monitor",
  "payment_type": "one_time",
  "status": "paid",
  "customer": {
    "email": "customer@example.com",
    "first_name": "Jane",
    "last_name": "Doe"
  },
  "products": [
    {
      "merchant_product_id": "BP-MONITOR-001",
      "name": "Blood Pressure Monitor",
      "quantity": 1,
      "price": 4995,
      "hsa_fsa_eligible": true
    }
  ],
  "order": {
    "id": "ord_xyz789",
    "status": "completed",
    "paid_at": "2026-02-25T15:30:00Z"
  },
  "success_url": "https://yoursite.com/success",
  "cancel_url": "https://yoursite.com/cancel",
  "metadata": {
    "order_id": "ORD-12345"
  },
  "expires_at": "2026-03-12T14:30:00Z",
  "created_at": "2026-02-25T14:30:00Z",
  "paid_at": "2026-02-25T15:30:00Z"
}
```

## Response Fields

| Field | Type | Description |
| :- | :- | :- |
| `id` | string | Unique payment link identifier |
| `url` | string | Checkout URL for the payment link |
| `amount` | integer | Total amount in cents |
| `status` | enum | `active`, `paid`, `expired`, or `cancelled` |
| `order` | object | Associated order (present when `status` is `paid`) |
| `order.id` | string | Order ID |
| `order.status` | enum | Order status |
| `order.paid_at` | timestamp | When payment was completed |
| `paid_at` | timestamp | When link was paid (null if not paid) |

## Example

```bash theme={null}
curl https://api.withgale.com/api/v2/payment-links/plink_abc123xyz \
  -H "Authorization: Bearer glm_test_YOUR_API_KEY"
```

## Payment Link Status

| Status | Description |
| :- | :- |
| `active` | Link is ready to accept payment |
| `paid` | Payment completed, order created |
| `expired` | Link expired without payment |
| `cancelled` | Link was manually cancelled |

## Errors

| Status Code | Error Code | Description |
| :- | :- | :- |
| 401 | `unauthorized` | Invalid or missing API key |
| 404 | `not_found` | Payment link not found |

## Related

* [Create Payment Link](/api-reference/endpoint/create-payment-link)
* [List Payment Links](/api-reference/endpoint/list-payment-links)
* [Cancel Payment Link](/api-reference/endpoint/cancel-payment-link)
* [Order Object](/api-reference/objects/order)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.