Dispute

Gestionarea disputelor la plati. Toate endpoint-urile necesita autentificare.

GET /disputes

Listeaza disputele utilizatorului autentificat.

curl "https://api.paylinks.ro/api/v1/disputes?status=OPEN&limit=20" \
  -H "Authorization: Bearer YOUR_TOKEN"

Parametri query:

Parametru	Tip	Implicit	Descriere
limit	integer	20	Elemente per pagina
offset	integer	0	Offset de paginare
status	string	—	Filtru: OPEN, UNDER_REVIEW, WON, LOST

Raspuns (200):

{
  "data": [
    {
      "id": "disp-001",
      "transactionId": "tx-001",
      "stripeDisputeId": "dp_1234567890",
      "amount": 4999,
      "currency": "RON",
      "status": "OPEN",
      "reason": "fraudulent",
      "dueBy": "2026-03-01T00:00:00.000Z",
      "createdAt": "2026-02-15T10:00:00.000Z"
    }
  ],
  "total": 1
}

Statusuri dispute

Status	Descriere
OPEN	Disputa noua, se pot trimite dovezi
UNDER_REVIEW	Dovezi trimise, se asteapta decizia Stripe
WON	Disputa rezolvata in favoarea vanzatorului
LOST	Disputa rezolvata in favoarea cumparatorului

---

GET /disputes/:id

Obtine o singura disputa dupa ID.

curl https://api.paylinks.ro/api/v1/disputes/disp-001 \
  -H "Authorization: Bearer YOUR_TOKEN"

Raspuns (200): Obiectul complet al disputei.

---

POST /disputes/:id/evidence

Trimite dovezi pentru o disputa.

curl -X POST https://api.paylinks.ro/api/v1/disputes/disp-001/evidence \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "uncategorizedText": "Customer received the digital product on Feb 15. Download logs attached.",
    "uncategorizedFile": "https://files.paylinks.ro/evidence/receipt.pdf"
  }'

Corpul cererii:

Camp	Tip	Obligatoriu	Descriere
uncategorizedText	string	Nu	Dovezi text
uncategorizedFile	string	Nu	URL catre fisierul de dovezi

Raspuns (200):

{"message": "Evidence submitted"}