Transactions

Transaction history. All endpoints require authentication.

GET /transactions

List one-time transactions for the authenticated seller.

curl "https://api.paylinks.ro/api/v1/transactions?limit=50&status=succeeded" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Currency: RON"

Query Parameters:

Parameter	Type	Default	Description
limit	integer	50	Items per page (max 100)
cursor	string	—	Pagination cursor (transaction.id)
status	string	all	Filter: all, succeeded, failed, refunded, disputed, uncaptured, requires_action

Response (200):

{
  "items": [
    {
      "id": "cm7v3q9y70000q8h6n7r3u1w2",
      "amount": 4999,
      "currency": "RON",
      "status": "SUCCEEDED",
      "paymentMethodType": "card",
      "cardBrand": "visa",
      "cardLast4": "4242",
      "stripePaymentIntentId": "pi_1234567890",
      "stripeChargeId": "ch_1234567890",
      "receiptUrl": "https://pay.stripe.com/receipts/...",
      "description": "Premium Course",
      "createdAt": "2026-02-16T14:30:00.000Z",
      "customerId": "cm7v3q9y80001q8h6z5v2h9k1",
      "cardCountry": "RO",
      "customer": {
        "id": "cm7v3q9y80001q8h6z5v2h9k1",
        "email": "[email protected]",
        "name": "Ion Popescu",
        "phone": "+40712345678",
        "country": "RO"
      }
    }
  ],
  "counts": {
    "all": 120,
    "succeeded": 110,
    "refunded": 5,
    "disputed": 2,
    "failed": 3,
    "uncaptured": 0
  },
  "nextCursor": "cm7v3q9y70000q8h6n7r3u1w2"
}