---
title: Track a Payment Link
slug: payment-links/track
excerpt: >-
  Monitor payment link status, track conversions, and manage active links using
  the Dashboard and API. Use merchant references for reconciliation.
hidden: false
sidebar_order: 5
metadata:
  title: Track Payment Links – Pine Labs
  description: >-
    Monitor payment link status, track conversions, and manage active links
    using the Dashboard and API.
  robots: index
---
Monitor payment link activity, payment status, and conversion performance using the Pine Labs Online Dashboard and APIs.

After sharing a payment link through SMS and email, you can track the complete payment lifecycle — including whether the customer opened the link, initiated payment, completed the transaction, or if the link expired.

Pine Labs Online provides both Dashboard-based monitoring and API-based tracking capabilities to help businesses manage payment operations, customer follow-ups, reporting, and reconciliation workflows efficiently.

Use the merchant_payment_link_reference to map transactions with your internal systems, orders, CRM platforms, or accounting workflows for accurate reconciliation and operational tracking.

You can:

- Track payment link status in real time
- Monitor payment success and conversion rates
- Identify expired or unpaid links
- Reconcile payments using merchant references
- Fetch payment link details using APIs
- Manage payment operations from the Dashboard

---
## Sign Up & Get API Credentials
 
<TwoColumn ratio="1:1" gap="2rem" align="start">
<Column>
 
Before using APIs, sign in to the Pine Labs Online Dashboard and generate your Client ID and Client Secret to authenticate API requests securely.
 
1. **Sign Up** — Visit the Pine Labs Online Dashboard and register with your business email.
 
<a class="hidden sm:inline-flex btn-light-green px-3.5 py-1.5 text-sm shadow-sm" href="https://dashboardv2.pluralonline.com/signup">Create Account</a>
 
2. **Verify Your Email** — Confirm your email address through the verification link sent to your inbox.
3. **Find Your Credentials** — Once logged in, navigate to Settings → API Keys to generate your test-mode API key and secret.
4. **Explore the Dashboard** — Use the dashboard to view test payments, refunds, settlements, and webhook configurations before going live.
 
Once your account is ready, you can immediately start integrating hosted checkout, custom checkout, payment links, tokenization, and other Pine Labs Online payment solutions using the UAT environment — no production credentials required.
</Column>
<Column>
 
<DocImage src="images/dashboard/signup.png" alt="Pine Labs Dashboard" align="center" /> 
  </Column>
</TwoColumn>

---

## Track payments in the Dashboard

The **Payment Links** section in the Pine Labs Dashboard provides real-time visibility into all your payment links:

- **Status indicators** — See the current state of each link: `CREATED`, `CLICKED`, `PAYMENT_INITIATED`, `PROCESSED`, `CANCELLED`, `EXPIRED`.
- **Search and filter** — Find links by merchant reference, status, date range, or amount.
- **Conversion tracking** — Identify which links converted into payments and which were abandoned.
- **Payment details** — Click any link to see full details including customer info, payment method used, and timestamps.

---


## Track payments with the API

Use the retrieval APIs to check the status of any payment link programmatically. This is useful for automated reconciliation, order fulfillment, and reporting.

### Get payment link by ID

Retrieve a payment link using the Pine Labs-assigned `payment_link_id`:

```bash
curl --request GET \
  --url https://pluraluat.v2.pinepg.in/api/pay/v1/paymentlink/{payment_link_id} \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json'
```

**API Reference:** [Get Payment Link by Payment Link ID](/api/payment-links/get-payment-link-by-id)

### Get payment link by merchant reference

Retrieve a payment link using your own `merchant_payment_link_reference`:

```bash
curl --request GET \
  --url https://pluraluat.v2.pinepg.in/api/pay/v1/paymentlink/merchant-reference/{merchant_payment_link_reference} \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json'
```

This is useful when you want to look up a link using your internal order ID, invoice number, or CRM reference.

**API Reference:** [Get Payment Link by Merchant Payment Link Reference](/api/payment-links/get-payment-link-by-merchant-reference)

---

## Simplify reconciliation with merchant references

Use the `merchant_payment_link_reference` parameter when creating a link to attach your own identifier — such as an order ID, invoice number, or customer ID. This lets you:

- Look up payment links using your own internal IDs
- Match Pine Labs payments to your order or invoicing system
- Reconcile settlements against your records

```json
{
  "merchant_payment_link_reference": "INV-2025-00456"
}
```

> 📘 **Best practice**
>
> Always set a meaningful `merchant_payment_link_reference` for every link. This is required by the API and critical for reconciliation.

---

## Payment link lifecycle

Track how your links progress through these states:

| Status | What it means | What to do |
|---|---|---|
| `CREATED` | Link is active and sent to the customer. | Wait for customer action, or resend if needed. |
| `CLICKED` | Customer opened the link but hasn't paid. | Payment is expected. Follow up if status persists. |
| `PAYMENT_INITIATED` | Customer started checkout (order created). | Payment is in progress. Do not cancel. |
| `PROCESSED` | Payment completed successfully. | Fulfill the order. Verify via webhook or API. |
| `CANCELLED` | You cancelled the link. | No further action. Create a new link if needed. |
| `EXPIRED` | Link exceeded the `expire_by` timestamp. | Create a new link if payment is still needed. |

---

## Track payments with webhooks

For real-time tracking without polling, set up [webhooks](/developer-tools/webhooks). Pine Labs sends a server-to-server notification when a payment link is processed.

Key steps:

1. **Configure your webhook URL** in the [Pine Labs Dashboard settings](/dashboard/settings).
2. **Verify the webhook signature** to ensure the notification is authentic. See [Signature Verification](/developer-tools/webhooks/signature-verification).
3. **Process the event** and update your order or invoice status.

> 📘 **Why webhooks?**
>
> Webhooks are the most reliable way to confirm payments. They work even if the customer closes their browser before the callback redirect, or if network issues prevent the redirect.

For the full list of events, see [Available Events](/developer-tools/webhooks/available-events).

---

## Cancel a payment link

Cancel an active link that hasn't been paid:

### Via API

```bash
curl --request PUT \
  --url https://pluraluat.v2.pinepg.in/api/pay/v1/paymentlink/{payment_link_id}/cancel \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json'
```

### Via Dashboard

Find the link in the Payment Links section and click **Cancel**.

> 🚧 You can only cancel a link with status `CREATED` or `CLICKED`. Links with `PAYMENT_INITIATED` or `PROCESSED` status cannot be cancelled.

**API Reference:** [Cancel Payment Link](/api/payment-links/cancel-payment-link)

---

## Resend a payment link notification

If the customer hasn't acted on the link, resend the SMS and email notification:

### Via API

```bash
curl --request PATCH \
  --url https://pluraluat.v2.pinepg.in/api/pay/v1/paymentlink/{payment_link_id}/resend \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json'
```

### Via Dashboard

Find the link and click **Resend**.

**API Reference:** [Resend Payment Link Notification](/api/payment-links/resend-payment-link-notification)

---

## Monitoring best practices

| Practice | Why |
|---|---|
| **Use webhooks** | Get real-time notifications without polling. |
| **Set meaningful references** | Makes reconciliation with your systems easy. |
| **Follow up on `CLICKED` links** | If status stays at `CLICKED`, the customer may need a reminder or help. |
| **Monitor expiring links** | Resend or create new links before expiry if payment is still needed. |
| **Track conversion rates** | Use the Dashboard to see how many links convert into payments. Optimize link sending time and channel. |

---

## See also

- [Payment Links overview](payment-links) — features, use cases, and comparison
- [After you receive payment](/payment-links/post-payment) — verification, refunds, and settlements
- [Webhooks](/developer-tools/webhooks) — real-time payment notifications