Track a Payment Link

Monitor payment link status, track conversions, and manage active links using the Dashboard and API. Use merchant references for reconciliation.

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

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.
  1. Verify Your Email — Confirm your email address through the verification link sent to your inbox.
  2. Find Your Credentials — Once logged in, navigate to Settings → API Keys to generate your test-mode API key and secret.
  3. 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.

Pine Labs Dashboard

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

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


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:

StatusWhat it meansWhat to do
CREATEDLink is active and sent to the customer.Wait for customer action, or resend if needed.
CLICKEDCustomer opened the link but hasn't paid.Payment is expected. Follow up if status persists.
PAYMENT_INITIATEDCustomer started checkout (order created).Payment is in progress. Do not cancel.
PROCESSEDPayment completed successfully.Fulfill the order. Verify via webhook or API.
CANCELLEDYou cancelled the link.No further action. Create a new link if needed.
EXPIREDLink 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. 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.
  2. Verify the webhook signature to ensure the notification is authentic. See 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.


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


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


Monitoring best practices

PracticeWhy
Use webhooksGet real-time notifications without polling.
Set meaningful referencesMakes reconciliation with your systems easy.
Follow up on CLICKED linksIf status stays at CLICKED, the customer may need a reminder or help.
Monitor expiring linksResend or create new links before expiry if payment is still needed.
Track conversion ratesUse the Dashboard to see how many links convert into payments. Optimize link sending time and channel.

See also

New chat
Responses are generated using AI and may contain mistakes.
Hi! I'm Pine, your AI developer assistant. Ask me anything about Pine Labs APIs, integrations, or troubleshooting.

Tip: you can create a new chat with + E