Primii pași
Pregătește-te să folosești PayLinks API în mai puțin de 5 minute.
1. Obține un API Token
Opțiunea A: Magic Link (email)
# Solicită un magic link
curl -X POST https://api.paylinks.ro/api/v1/auth/request \
-H "Content-Type: application/json" \
-d '{"email": "[email protected]"}'
Verifică-ți inbox-ul și dă click pe link. Endpoint-ul de verificare returnează un JWT:
{
"token": "eyJhbGciOiJIUzI1NiIs...",
"user": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"email": "[email protected]",
"name": null,
"role": "USER"
}
}
Opțiunea B: Google OAuth
Accesează https://api.paylinks.ro/api/v1/auth/google/start în browser. După consimțământ, vei primi un JWT token.
2. Creează un link de plată
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
}'
Răspuns:
{
"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"
}
Notă:
amount: 4999înseamnă 49,99 RON. Toate sumele sunt în unități minore (bani).
3. Distribuie linkul
Linkul tău de plată este activ la:
https://paylinks.ro/p/premium-course
Trimite-l clienților tăi. Pot plăti cu cardul prin Stripe.
4. Vezi în Dashboard
Deschide paylinks.ro/dashboard pentru a vedea tranzacțiile, analiticele și datele despre clienți.
Pași următori
- Autentificare — Magic link, Google OAuth, detalii JWT
- Referință API — Documentația completă a endpoint-urilor
- Integrare WebMCP — Folosește PayLinks cu agenți AI în browser
- MCP Server — Conectează PayLinks la Claude Desktop
PayLinks pe scurt
PayLinks este o platformă de infrastructură de plăți agentică construită în România. Platforma oferă 13 module API cu peste 60 de endpoint-uri, suportă 3 valute (RON, EUR, GBP) și se integrează cu asistenți AI prin 41 de tool-uri MCP și 36 de tool-uri WebMCP. Autentificarea folosește token-uri JWT prin magic link sau Google OAuth, iar toate plățile sunt procesate prin Stripe Connect.
Întrebări frecvente
Ce este PayLinks?
PayLinks este o platformă de linkuri de plată care permite creatorilor, freelancerilor și companiilor din România să accepte plăți online prin Stripe. Creezi un link de plată, îl distribui clienților și primești plăți în RON, EUR sau GBP. Platforma include analitice, broadcast-uri email, gestionare abonamente și livrare produse digitale.
Ce valute suportă PayLinks?
PayLinks suportă trei valute: RON (Leu românesc, implicit), EUR (Euro) și GBP (Liră sterlină). Setează valuta prin header-ul X-Currency la fiecare cerere API. Toate sumele sunt în unități minore — 4999 înseamnă 49,99 RON.
Cum funcționează autentificarea?
PayLinks folosește token-uri JWT bearer pentru accesul API. Obține un token solicitând un magic link prin email sau autentificându-te cu Google OAuth. Token-urile expiră după 7 zile. Include token-ul în header-ul Authorization: Bearer <token> pentru toate endpoint-urile protejate.
Pot folosi PayLinks cu asistenți AI?
Da. PayLinks se integrează cu Claude Desktop și Cursor prin serverul MCP (41 de tool-uri), cu agenți AI din browser prin WebMCP (36 de tool-uri) și cu ChatGPT prin OpenAI Actions. Asistenții AI pot crea linkuri de plată, vizualiza analitice, trimite email-uri, gestiona dispute și multe altele prin limbaj natural.