Payment Links Integration - Stablio Documentation

Overview

Payment Links allow you to create pre-configured payment URLs that customers can use to make payments. Perfect for invoicing, selling products, or collecting donations without any technical integration.

No coding required

Create payment links directly from your dashboard with just a few clicks.

Share anywhere

Use links in emails, SMS, social media, QR codes, or printed materials

Creating Payment Links

Method 1: Using the Dashboard (Recommended)

The easiest way to create payment links is through your Stablio dashboard:

1

Navigate to POSs

Go to the "POSs" tab in your dashboard and click "Setup Pay by Link".

2

Configure Payment Details

Select supported blockchains, set the payment amount, currency, and optional webhook URL.

3

Generate and Share

Click "Create Link" to generate your payment URL and share it with customers.

Method 2: Using the API

For programmatic creation of payment links, use the Setup Payment ID API endpoint:

POST /api/setupPaymentID
Authorization: Bearer YOUR_JWT_TOKEN
Content-Type: application/json

{
    "vendorID": "your_vendor_id",
    "amount": 49.99,
    "currency": "USD",              // 'USD' or 'EUR' [optional]
    "chains": ["solana", "base"],    // Supported blockchains
    "webhook": "https://your-site.com/webhook"   // [optional]
}

// Response
{
    "paymentID": "abc123def456"
}

The payment link URL format is:

https://pay.stablio.eu/link/{vendorID}/{paymentID}

Optionally, add a customer ID for tracking:

https://pay.stablio.eu/link/{vendorID}/{paymentID}?userID={customerID}

Payment Link Features

Customer Identification (Optional)

You can optionally add a customer ID to track payments by appending it to your payment link. This parameter is completely optional and the payment link will work without it:

// Basic payment link (works without userID)
https://pay.stablio.eu/link/your_vendor/abc123

// With optional customer tracking
https://pay.stablio.eu/link/your_vendor/abc123?userID=customer_123

Webhook Notifications

Receive real-time payment updates by providing a webhook URL when creating the payment link. See our webhook documentation for implementation details.

API Reference

Setup Payment ID

Parameter	Type	Required	Description
vendorID	string	Yes	Your unique vendor identifier
amount	number	Yes	Payment amount
chains	string[]	Yes	Supported blockchains: ['solana', 'base']
currency	string	Optional	'USD' or 'EUR' (defaults to 'USD')
webhook	string	Optional	URL to receive payment notifications

Get Payment Links

Retrieve all your created payment links:

POST /api/getPaymentByLinkIDs
Authorization: Bearer YOUR_JWT_TOKEN
Content-Type: application/json

{
    "vendorID": "your_vendor_id"
}

Payment Link URL Structure

Component	Required	Description	Example
Base URL	Yes	Stablio payment domain	https://pay.stablio.eu/link/
Vendor ID	Yes	Your unique vendor identifier	your_vendor_123
Payment ID	Yes	Unique payment identifier	abc123def456
User ID	Optional	Customer identifier query parameter	?userID=customer_123

Use Cases

Email Invoicing

Include payment links in email invoices for immediate payment collection.

QR Code Payments

Generate QR codes from payment links for in-person transactions.

Social Media

Share links on social platforms for donations.

Best Practices

🔗 Keep Links Organized

Use meaningful customer IDs in your payment links to track transactions effectively.

🔔 Set Up Webhooks

Configure webhook notifications to receive real-time payment confirmations.

💰 Consider Currency

Choose the appropriate currency (USD/EUR) based on your target audience.

Web Checkout Custom UI