Clienti

Date despre clienti segmentate dupa comportament. Necesita autentificare.

GET /customers

Listeaza clientii, optional filtrati dupa segment.

curl "https://api.paylinks.ro/api/v1/customers?segment=top&limit=20" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Currency: RON"

Parametri query:

Parametru	Tip	Implicit	Descriere
limit	integer	50	Elemente per pagina (max 100)
cursor	string	—	Cursor de paginare (customer.id)
segment	string	all	Filtru: all, top, first-time, repeat, recent, high-refunds, high-disputes

Raspuns (200):

{
  "items": [
    {
      "id": "cm7v3x8h00001j1s0z0o2h4r4",
      "name": "Ion Popescu",
      "email": "[email protected]",
      "phone": "+40712345678",
      "addressLine1": "Str. Lalelelor 10",
      "addressLine2": null,
      "city": "Bucuresti",
      "postalCode": "010101",
      "state": null,
      "country": "RO",
      "createdAt": "2026-02-01T10:00:00.000Z",
      "updatedAt": "2026-02-16T14:30:00.000Z",
      "totalAmount": 14997,
      "payments": 3,
      "lastPayment": {
        "date": "2026-02-16T14:30:00.000Z",
        "cardBrand": "visa",
        "cardLast4": "4242",
        "currency": "RON",
        "status": "SUCCEEDED"
      }
    }
  ],
  "counts": {
    "all": 235
  },
  "nextCursor": "cm7v3x8h00001j1s0z0o2h4r4"
}

Note:

• counts.all este populat.
• Restul contoarelor pe segmente sunt rezervate si pot lipsi.