Skip to main content
Retorna uma lista paginada de todos os pagamentos. Pode ser filtrado por cliente.

​
Endpoint

curl -G https://api.upag.io/v1/payments \
  -H "Authorization: Bearer {token}" \
  -d page=1 \
  -d limit=10 \
  -d customer=cus_ahwDXrgYvur89iPs

​
Parâmetros

​
limit
integer
Limita o número de pagamentos retornados. Padrão: 10, máximo: 100.
​
page
integer
Número da página a ser retornada. Padrão: 1.
​
customer
string
ID do cliente (UUID) para filtrar pagamentos de um cliente específico.

​
Resposta

Response
{
  "data": [
    {
      "id": "pay_xyz789abc",
      "livemode": false,
      "customer": {
        "id": "cus_ahwDXrgYvur89iPs",
        "name": "John Doe",
        "email": "[email protected]"
      },
      "paymentMethod": {
        "id": "pm_abc123xyz",
        "type": "credit_card",
        "lastDigits": "1111",
        "brand": "visa"
      },
      "amount": 10000,
      "gross": 10000,
      "mdr": 0,
      "net": 10000,
      "interest": 0,
      "currency": "BRL",
      "status": "paid",
      "pixQrCode": null,
      "refuseReason": null,
      "installments": 1,
      "createdAt": 1731622178441,
      "updatedAt": 1731622178441,
      "dueAt": null
    }
  ],
  "total": 1
}