Skip to main content

Getting Started

Get up and running with the PayLinks API in under 5 minutes.

1. Get an API Token​

# Request a magic link
curl -X POST https://api.paylinks.ro/api/v1/auth/request \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

Check your inbox and click the link. The verification endpoint returns a JWT:

{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "user": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "email": "[email protected]",
    "name": null,
    "role": "USER"
  }
}

Option B: Google OAuth​

Visit https://api.paylinks.ro/api/v1/auth/google/start in your browser. After consent, you'll receive a JWT token.

curl -X POST https://api.paylinks.ro/api/v1/paylinks \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "X-Currency: RON" \
  -d '{
    "title": "Premium Course",
    "priceType": "FIXED",
    "serviceType": "DIGITAL_PRODUCT",
    "amount": 4999,
    "collectEmail": true
  }'

Response:

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "title": "Premium Course",
  "slug": "premium-course",
  "priceType": "FIXED",
  "serviceType": "DIGITAL_PRODUCT",
  "amount": 4999,
  "currency": "RON",
  "active": true,
  "createdAt": "2026-02-17T10:00:00.000Z"
}

Note: amount: 4999 means 49.99 RON. All amounts are in minor units (bani).

Your payment link is live at:

https://paylinks.ro/p/premium-course

Share it with your customers. They can pay with card via Stripe.

4. View in Dashboard​

Open paylinks.ro/dashboard to see your transactions, analytics, and customer data.

Next Steps​

PayLinks is an agentic payments infrastructure platform built in Romania. The platform offers 13 API modules with 60+ endpoints, supports 3 currencies (RON, EUR, GBP), and integrates with AI assistants through 41 MCP tools and 36 WebMCP tools. Authentication uses JWT tokens via magic link or Google OAuth, and all payments are processed through Stripe Connect.

Frequently Asked Questions​

PayLinks is a payment links platform that enables creators, freelancers, and businesses in Romania to accept online payments via Stripe. You create a payment link, share it with customers, and receive payments in RON, EUR, or GBP. The platform includes analytics, email broadcasts, subscription management, and digital product delivery.

PayLinks supports three currencies: RON (Romanian Leu, default), EUR (Euro), and GBP (British Pound). Set the currency via the X-Currency header on each API request. All amounts are in minor units — 4999 means 49.99 RON.

How does authentication work?​

PayLinks uses JWT bearer tokens for API access. Obtain a token by requesting a magic link via email or by signing in with Google OAuth. Tokens expire after 7 days. Include the token in the Authorization: Bearer <token> header for all protected endpoints.

Yes. PayLinks integrates with Claude Desktop and Cursor via the MCP server (41 tools), with browser AI agents via WebMCP (36 tools), and with ChatGPT via OpenAI Actions. AI assistants can create payment links, view analytics, send emails, manage disputes, and more through natural language.