Listar Carteiras

#Visão Geral

Este endpoint permite listar todas as carteiras associadas a um vendedor específico ou filtrar por determinados critérios.

#Precauções

• Utilize os parâmetros de paginação para gerenciar grandes volumes de dados.
• Certifique-se de utilizar o ID correto do vendedor para obter as carteiras associadas.
• Os resultados são ordenados por data de criação, do mais recente para o mais antigo.

#Descrição

A listagem de carteiras permite visualizar todas as contas bancárias configuradas para um vendedor. Este endpoint é útil para verificar quais carteiras estão disponíveis antes de realizar operações como exclusão ou atualização.

#Requisição

GET /v1/wallets

#Parâmetros de Consulta

#Exemplo de Requisição

GET /v1/wallets?limit=25&offset=0

#Resposta

#Sucesso (200 OK)

Resposta paginada no nível raiz (com merchant e _links).

{
  "offset": 0,
  "limit": 25,
  "total": 1,
  "hasMore": false,
  "page": {
    "current": 1,
    "total": 1,
    "offset": { "first": 0, "prev": 0, "next": 0, "last": 0 }
  },
  "data": [
    {
      "id": "wall_01hqzvabc",
      "name": "Minha Carteira Principal",
      "holderName": "João Santos",
      "bankName": null,
      "bankCode": "260",
      "routingNumber": "0001",
      "accountNumber": "11111111-5",
      "accountType": "checking",
      "pixKey": null,
      "primary": true,
      "enabled": true,
      "updatedAt": "2026-04-12T17:56:33.000Z",
      "createdAt": "2026-04-12T17:56:33.000Z"
    }
  ],
  "merchant": {
    "name": "Seller Name",
    "merchantId": "bus_1234567890",
    "isSubAccount": false
  },
  "_links": {
    "self": {
      "href": "https://api.selectwin.io/v1/wallets",
      "method": "GET",
      "description": "List all wallets."
    },
    "create": {
      "href": "https://api.selectwin.io/v1/wallets",
      "method": "POST",
      "description": "Create a new wallet."
    }
  }
}

#Atributos da Resposta Paginada

#Melhores Práticas

1. Utilize paginação para lidar com grandes volumes de dados, especialmente para vendedores com muitas carteiras.
2. Identifique a carteira principal pelo item com primary: true no resultado (não há filtro de consulta para isso).
3. Verifique a resposta de paginação para garantir que você tenha acessado todos os registros disponíveis.
4. Utilize cache quando apropriado para melhorar o desempenho ao fazer consultas frequentes.
5. Limite o número de requisições para respeitar os limites de taxa da API.
6. Armazene os IDs das carteiras para referência futura quando precisar interagir com elas individualmente.