​
Tracing in PayLink

🔍
PayLink provides a powerful tracing platform to help developers monitor, debug, and optimize their payment integrations.
PayLink Tracing is a monitoring and debugging tool that gives you visibility into how your payment tools are being called by agents and what parameters are being passed. This visibility is crucial for debugging issues, understanding payment flows, and optimizing your integration.

​
Benefits of Tracing

​
🐛 Debug with Confidence

Quickly identify and resolve issues by seeing exactly what parameters were passed to each tool and how the system responded.

​
📈 Monitor Performance

Track response times and success rates for different payment operations to optimize your application.

​
🔎 Audit Transactions

Maintain a complete audit trail of all payment activities for compliance and reconciliation purposes.

​
Enabling Tracing

To enable tracing for your PayLink integration, set the PAYLINK_TRACING environment variable to enabled in your .env file: 
# PayLink credentials
PAYLINK_API_KEY=your_api_key_here
PAYLINK_PROJECT=your_project_name
PAYLINK_TRACING=enabled  # Enable tracing
Alternatively, you can enable tracing when initializing the PayLink client: 
from paylink_sdk import PayLinkClient

# Enable tracing explicitly
client = PayLinkClient(tracing="enabled")

​
Accessing Trace Data

Access your PayLink dashboard at https://paylink-platform-izl1.vercel.app/

​
2. Navigate to Tracing Tab

Click the tracing tab to be able to see list of all the projects being traced

Navigate to Tracing Tab

Tracing tab showing list of projects with active traces

​
3. View Traces

To view the traces, click on the project name

View Traces

Viewing traces for a specific project

​
4. View Tool Parameters

To view detailed parameters and responses, click on a specific tool name in the traces list

View Tool Parameters

Detailed view of tool parameters and response data

​
Best Practices

  • Use different project names: If you want to trace multiple projects, make sure they have different project names. You can use the same API key for all projects while keeping their traces separate.
  • Enable tracing in development: Always have tracing enabled during development and testing.
  • Check traces immediately: When debugging issues, check the traces immediately after the operation.

​
Next Steps

Now that you understand PayLink’s tracing capabilities:

  • Enable tracing in your development environment
  • Familiarize yourself with the trace dashboard
  • Set up alerts for failed transactions
  • Learn how to troubleshoot common issues using trace data