Skip to main content
Tester en direct — Essayez ces endpoints dans la documentation interactive Scalar.

​
Lister les paiements

Scope requis : payments:read
​
status
string
Filtrer par statut : pending, completed, failed, refunded
​
fromDate
string
Date de début (ISO 8601). Exemple : 2026-01-01
​
toDate
string
Date de fin (ISO 8601). Exemple : 2026-03-31
​
invoiceId
string
Filtrer par ID de facture associée (UUID)
​
page
number
default:"1"
Numéro de page
​
limit
number
default:"20"
Résultats par page (max 100)
curl -H "X-API-Key: fk_live_xxx" \
  "https://api.finkare.io/api/v1/payments?status=completed&fromDate=2026-01-01&toDate=2026-03-31"

{
  "success": true,
  "data": [
    {
      "id": "d4e5f6a7-b1c2-8901-def0-234567890abc",
      "invoiceId": "c3d4e5f6-a1b2-7890-cdef-1234567890ab",
      "amountCents": 150000,
      "currency": "EUR",
      "status": "completed",
      "method": "card",
      "paidAt": "2026-03-10T14:22:00Z"
    },
    {
      "id": "e5f6a7b8-c1d2-9012-ef01-345678901bcd",
      "invoiceId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "amountCents": 50000,
      "currency": "EUR",
      "status": "completed",
      "method": "bank_transfer",
      "paidAt": "2026-03-15T09:45:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 2
  },
  "requestId": "req_p1a2y3",
  "timestamp": "2026-04-08T10:00:00Z"
}

​
Récupérer un paiement

Scope requis : payments:read
​
id
string
required
ID du paiement (UUID)
curl -H "X-API-Key: fk_live_xxx" \
  https://api.finkare.io/api/v1/payments/d4e5f6a7-b1c2-8901-def0-234567890abc

{
  "success": true,
  "data": {
    "id": "d4e5f6a7-b1c2-8901-def0-234567890abc",
    "invoiceId": "c3d4e5f6-a1b2-7890-cdef-1234567890ab",
    "amountCents": 75000,
    "currency": "EUR",
    "status": "completed",
    "method": "card",
    "paidAt": "2026-03-10T14:22:00Z"
  },
  "requestId": "req_x1y2z3",
  "timestamp": "2026-04-08T10:00:00Z"
}
​
data.amountCents
number
Montant du paiement en centimes. Peut être inférieur au montant de la facture (paiement partiel).
​
data.status
string
Statut du paiement : pending (en cours), completed (confirmé), failed (échoué), refunded (remboursé)
​
data.method
string
Méthode de paiement : card, bank_transfer, sepa_debit, payment_link

​
Paiements d’une facture

Récupère tous les paiements associés à une facture (utile pour les paiements partiels). Scope requis : payments:read
​
invoiceId
string
required
ID de la facture (UUID)
curl -H "X-API-Key: fk_live_xxx" \
  https://api.finkare.io/api/v1/payments/invoice/c3d4e5f6-a1b2-7890-cdef-1234567890ab

{
  "success": true,
  "data": [
    {
      "id": "d4e5f6a7-b1c2-8901-def0-234567890abc",
      "amountCents": 75000,
      "status": "completed",
      "method": "card",
      "paidAt": "2026-03-10T14:22:00Z"
    },
    {
      "id": "f6a7b8c9-d1e2-0123-f012-456789012cde",
      "amountCents": 75000,
      "status": "completed",
      "method": "bank_transfer",
      "paidAt": "2026-03-25T11:00:00Z"
    }
  ],
  "requestId": "req_inv_pay_01",
  "timestamp": "2026-04-08T10:00:00Z"
}

​
Statistiques des paiements

Scope requis : reports:read
​
period
string
Période d’agrégation : day, week, month, year
curl -H "X-API-Key: fk_live_xxx" \
  "https://api.finkare.io/api/v1/payments/stats/summary?period=month"

{
  "success": true,
  "data": {
    "totalCollected": 4250000,
    "totalPending": 350000,
    "currency": "EUR",
    "period": "month",
    "byMethod": {
      "card": 2100000,
      "bank_transfer": 1500000,
      "sepa_debit": 650000
    },
    "conversionRate": 87.4
  },
  "requestId": "req_stats_p01",
  "timestamp": "2026-04-08T10:00:00Z"
}