Historico de pagamentos

Retorna o historico das invoices criadas.

URL

Autorizacao obrigatoria

GET

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

Formato da requisicaopathParam

page

number

Numero da pagina

Padrao: 1

Formato da respostadata object

id

uuid

ID da invoice

status

string

Status do pagamento (veja Status de pagamento)

created_at

string (ISO 8601 (RFC 3339), UTC)

Data de criacao do pagamento

Exemplos de requisição

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'

Resposta bem-sucedida

{
  "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
  }
}

Erros

A lista detalhada de erros de autorizacao esta em Autorizacao - Erros

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