Historique des paiements

Renvoie l'historique des factures créées.

URL

Autorisation requise

GET

https://api.fps.pro/invoices/history

Format de requêtepathParam

page

number

Numéro de page

Par défaut: 1

Format de réponsedata object

id

uuid

ID de facture

status

string

Statut du paiement (voir Statuts de paiement)

created_at

string (ISO 8601 (RFC 3339), UTC)

Date de création du paiement

Exemples de requête

curl --request GET 'https://api.fps.pro/invoices/history?page=1' \
  --header 'X-Client-Id: YOUR_CLIENT_ID' \
  --header 'X-Timestamp: 1720000000' \
  --header 'X-Signature: YOUR_HMAC_SHA256_SIGNATURE'

Réponse réussie

{
  "status": 200,
  "message": "success",
  "data": [
    {
      "id": "0a718b02-138d-495a-9661-39ca52139c07",
      "status": "paid",
      "created_at": "2026-01-05T13:30:43.000Z"
    }
  ],
  "meta": {
    "total": 1,
    "page": 1,
    "per_page": 20,
    "last_page": 1
  }
}

Erreurs

La liste détaillée des erreurs d'autorisation se trouve dans Autorisation - Erreurs

{
  "status": 422,
  "message": "Validation Error",
  "errors": [
    {
      "field": "invoice",
      "message": "The invoice must be UUID."
    }
  ]
}
{
  "status": 500,
  "message": "Internal Server Error"
}