Saltar al contenido principal
GET
/
v1
/
refunds
Listar reembolsos
curl --request GET \
  --url https://plugin-pix-indirect.api.lerian.net/v1/refunds \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Account-Id: <x-account-id>'
{
  "items": [
    {
      "id": "019c96a0-0c53-7a8d-8e29-67971d96d0e3",
      "originalEndToEndId": "E123456789BR1234567890123456789",
      "returnEndToEndId": "D123456789BR1234567890123456789",
      "amount": "100.00",
      "status": "COMPLETED",
      "reason": "FR01",
      "createdAt": "2024-01-15T10:30:00Z"
    }
  ],
  "limit": 10,
  "page": 1,
  "total": 42
}

Autorizaciones

​
Authorization
string
header
requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Encabezados

​
X-Account-Id
string
requerido

Identificador único de la cuenta del Ledger de Midaz (formato UUID).

Parámetros de consulta

​
page
integer
predeterminado:1

Número de página para la paginación.

Rango requerido: x >= 1
​
limit
integer
predeterminado:10

Número máximo de elementos por página.

Rango requerido: 1 <= x <= 100
​
sort_order
enum<string>
predeterminado:asc

Dirección de ordenamiento: asc o desc.

Opciones disponibles:
asc,
desc
​
end_to_end
string

Filtra por el identificador end-to-end de la transferencia Pix original.

​
status
enum<string>

Filtra por el estado del reembolso (CREATED, PENDING, PROCESSING, COMPLETED, FAILED, CANCELLED).

Opciones disponibles:
CREATED,
PENDING,
PROCESSING,
COMPLETED,
FAILED,
CANCELLED
​
type
enum<string>

Filtra por la dirección del reembolso (CASHOUT o CASHIN).

Opciones disponibles:
CASHOUT,
CASHIN
​
modified_after
string

Filtra por registros modificados después de esta marca de tiempo (formato RFC3339: 2024-01-15T10:30:00Z).

​
modified_before
string

Filtra por registros modificados antes de esta marca de tiempo (formato RFC3339: 2024-01-15T10:30:00Z).

Respuesta

Lista de reembolsos recuperada correctamente.

​
items
object[]
​
limit
integer
Ejemplo:

10

​
page
integer
Ejemplo:

1

​
total
integer
Ejemplo:

42