> ## Documentation Index
> Fetch the complete documentation index at: https://docs.liquerapay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Referência

> Consulte os dados e o saldo da sua loja.

A **Loja** representa o seu merchant na Liquerapay. É a partir dela que você
acompanha o saldo e identifica a conta que está recebendo os pagamentos.

<CardGroup cols={2}>
  <Card title="Identificação" icon="id-card">
    `id` da loja é o mesmo `id` do seu merchant — use para conferir de qual
    conta é a chave de API em uso.
  </Card>

  <Card title="Saldo" icon="wallet">
    `balance` traz `available`, `pending` e `blocked` em centavos, no mesmo
    formato de `GET /me/balance`.
  </Card>
</CardGroup>

## Campos

| Campo               | Tipo           | Descrição                                              |
| ------------------- | -------------- | ------------------------------------------------------ |
| `id`                | string         | Identificador da loja (o `id` do merchant).            |
| `name`              | string \| null | Nome da loja. Derivado do cadastro (KYC) — ver abaixo. |
| `balance.available` | integer        | Saldo disponível para saque, em **centavos**.          |
| `balance.pending`   | integer        | Saldo aguardando confirmação, em **centavos**.         |
| `balance.blocked`   | integer        | Saldo retido para análise ou disputa, em **centavos**. |

## Como o `name` é definido

Não existe um campo editável de "nome da loja". O valor é derivado dos seus
dados de cadastro (KYC), na primeira opção disponível:

<Steps>
  <Step title="Nome fantasia">
    `nomeFantasia` do cadastro PJ.
  </Step>

  <Step title="Razão social">
    `razaoSocial` do cadastro PJ, se não houver nome fantasia.
  </Step>

  <Step title="Nome completo">
    `fullName` do cadastro PF.
  </Step>

  <Step title="Nome do usuário">
    Nome da conta que fez o login, como último recurso.
  </Step>
</Steps>

Enquanto o cadastro não estiver completo, `name` pode vir `null`.

## Operações disponíveis

| Operação                       | Endpoint        |
| ------------------------------ | --------------- |
| [Obter loja](/pages/store/get) | `GET /me/store` |

<Note>
  Esta rota exige um token de merchant com KYC `APPROVED`. Não há rota para
  alterar os dados da loja pela API — o cadastro é gerido pelo
  [painel](https://app.liquerapay.com).
</Note>