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=needs_response&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: needs_response, under_review, won, lost, closed

Raspuns (200):

{
  "disputes": [
    {
      "id": "disp-001",
      "transactionId": "tx-001",
      "stripeDisputeId": "dp_1234567890",
      "amount": 4999,
      "currency": "RON",
      "status": "needs_response",
      "reason": "fraudulent",
      "evidenceDueBy": "2026-03-01T00:00:00.000Z",
      "createdAt": "2026-02-15T10:00:00.000Z"
    }
  ],
  "total": 1,
  "limit": 20,
  "offset": 0
}

Statusuri dispute

Status	Descriere
needs_response	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
closed	Disputa inchisa pe Stripe

---

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. Forma de raspuns:

{
  "dispute": {
    "id": "disp-001",
    "status": "needs_response"
  }
}

---

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 '{
    "customerName": "John Doe",
    "customerEmail": "[email protected]",
    "productDescription": "Produs digital livrat instant",
    "sellerNotes": "Clientul a descarcat fisierele inainte de disputa",
    "fileKeys": ["users/u_123/disputes/disp_001/evidence.pdf"]
  }'

Corpul cererii:

Camp	Tip	Obligatoriu	Descriere
customerName	string	Nu	Numele complet al cumparatorului
customerEmail	string	Nu	Emailul cumparatorului
productDescription	string	Nu	Ce a fost livrat
shippingCarrier	string	Nu	Curierul folosit pentru livrare fizica
shippingTrackingNumber	string	Nu	Numar de tracking
shippingDate	date-time	Nu	Data expedierii
serviceDate	date-time	Nu	Data prestarii serviciului
sellerNotes	string	Nu	Context aditional de la vanzator
fileKeys	string[]	Nu	Chei R2 private pentru fisierele de dovada

Raspuns (200):

{"success": true}