Consultar Carteira

#Visão Geral

Este endpoint permite recuperar detalhes completos de uma carteira específica através do seu ID único.

#Precauções

• Certifique-se de utilizar um ID de carteira válido no formato wall_XXXXXXXXX.
• Verifique se você tem permissão para acessar a carteira requisitada.
• A carteira deve pertencer ao vendedor autenticado ou a um vendedor para o qual você tenha acesso.

#Descrição

A consulta de carteira é útil para obter todos os detalhes de uma carteira específica, incluindo informações bancárias, status, e dados de associação.

#Requisição

GET /v1/wallets/{walletId}

#Parâmetros de Caminho

#Resposta

#Sucesso (200 OK)

{
  "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/wall_01hqzvabc",
      "method": "GET",
      "description": "Read a wallet."
    },
    "create": {
      "href": "https://api.selectwin.io/v1/wallets",
      "method": "POST",
      "description": "Create a new wallet."
    },
    "delete": {
      "href": "https://api.selectwin.io/v1/wallets/wall_01hqzvabc",
      "method": "DELETE",
      "description": "Delete the wallet."
    },
    "list": {
      "href": "https://api.selectwin.io/v1/wallets",
      "method": "GET",
      "description": "List all wallets."
    }
  }
}

#Atributos da Resposta

#Melhores Práticas

1. Armazene o ID da carteira quando ela é criada para facilitar consultas futuras.
2. Implemente cache para resultados frequentemente acessados, considerando um TTL (Time To Live) apropriado.
3. Verifique se a resposta retorna o atributo primary para determinar se esta é a carteira principal do vendedor.
4. Valide o formato do ID da carteira antes de fazer a requisição para evitar erros de validação.
5. Implemente tratamento de erros adequado para lidar com casos onde a carteira não é encontrada.
6. Armazene os IDs das carteiras em seu sistema para referência futura.
7. Utilize este endpoint para verificar o status atual da carteira antes de realizar operações com ela.
8. Implemente cache para informações de carteiras frequentemente acessadas.
9. Trate adequadamente os erros para fornecer feedback claro aos usuários.
10. Não armazene informações sensíveis da carteira em logs ou bancos de dados desprotegidos.
11. Verifique se a carteira é a principal (primary: true) antes de realizar operações que dependam da carteira padrão.