Skip to main content

​
Visão geral

Este endpoint retorna uma lista paginada de todos os reembolsos processados na sua conta, com suporte a filtros por status, transação de origem e período.

​
Endpoint

curl --request GET \
  --url "https://api.avanttifinance.com/v1/refunds?status=completed&page=1&limit=20" \
  --header "Authorization: Bearer SEU_TOKEN_DE_ACESSO"

​
Parâmetros de consulta

​
status
string
Filtra pelo status do reembolso: pending, completed ou failed.
​
transaction_id
string
Filtra os reembolsos relacionados a uma transação específica.
​
page
integer
default:"1"
Número da página de resultados.
​
limit
integer
default:"20"
Quantidade de itens por página. Máximo de 100.

​
Resposta

​
data
array
Lista de objetos de reembolso.
​
pagination
object
Informações de paginação, incluindo página atual, total de páginas e total de registros.

​
Exemplo de resposta

{
  "data": [
    {
      "id": "ref_5a6b7c8d9e",
      "transaction_id": "txn_8f3a1b2c9d",
      "amount": 15000,
      "status": "completed",
      "reason": "solicitação do cliente",
      "created_at": "2026-06-09T11:20:00Z"
    },
    {
      "id": "ref_1a2b3c4d5e",
      "transaction_id": "txn_2c3d4e5f6a",
      "amount": 5000,
      "status": "pending",
      "reason": "produto indisponível",
      "created_at": "2026-06-08T15:45:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total_pages": 1,
    "total_items": 9
  }
}

​
Próximos passos

Reembolsar transação

Solicite um novo reembolso para uma transação.

Ver transação

Consulte os detalhes de uma transação específica.