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

# Dados da Conta

> Descubra o MCC, os meios de pagamento e as moedas habilitados na sua conta

Retorna os dados da conta associada à sua chave de API: identificação, status e,
principalmente, **as capacidades que você precisa conhecer antes de criar a primeira
cobrança**: o código de estabelecimento (MCC), os meios de pagamento habilitados e as
moedas aceitas.

<Note>
  **Comece por aqui.** O campo `mcc` é obrigatório ao criar um pedido e é específico da sua
  conta. Em vez de adivinhar ou deixar o valor fixo no código, consulte esta rota e use um
  dos `merchant_codes` retornados. O mesmo vale para `payment_methods` e `currencies`: enviar
  um meio ou moeda que não está habilitado faz a cobrança ser rejeitada na validação.
</Note>

A rota é escopada à sua chave e não recebe nenhum parâmetro: ela devolve **sempre a sua
própria conta**.

## Exemplos de Requisição

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET https://pay.autorizou.dev/api/v1/merchant \
      -H "Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc"
  ```

  ```javascript JavaScript theme={null}
  const account = await fetch('https://pay.autorizou.dev/api/v1/merchant', {
    headers: { 'Authorization': 'Bearer 4eC39HqLyjWDarjtT1zdp7dc' }
  }).then(r => r.json());

  // Use o MCC da conta ao criar o pedido, em vez de um valor fixo
  const mcc = account.merchant_codes[0].code;
  ```

  ```php PHP theme={null}
  <?php

  $curl = curl_init();
  curl_setopt_array($curl, [
      CURLOPT_URL => 'https://pay.autorizou.dev/api/v1/merchant',
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_HTTPHEADER => ['Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc'],
  ]);

  $account = json_decode(curl_exec($curl), true);
  $mcc = $account['merchant_codes'][0]['code'];
  ?>
  ```
</CodeGroup>

## Resposta

<ResponseField name="id" type="string">
  UUID da sua conta.
</ResponseField>

<ResponseField name="name" type="string">
  Nome de exibição (nome fantasia).
</ResponseField>

<ResponseField name="legal_name" type="string">
  Razão social.
</ResponseField>

<ResponseField name="status" type="string">
  Situação da conta. Cobranças só são aceitas com a conta `approved`.
</ResponseField>

<ResponseField name="merchant_codes" type="array">
  Códigos de estabelecimento (MCC) habilitados. Use `code` no campo `mcc` do pedido.

  <Expandable title="propriedades">
    <ResponseField name="code" type="string">Código MCC (4 dígitos).</ResponseField>
    <ResponseField name="description" type="string">Descrição do ramo.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="payment_methods" type="array">
  Meios de pagamento habilitados, ex.: `pix`, `credit_card`, `bank_slip`.
</ResponseField>

<ResponseField name="currencies" type="array">
  Moedas aceitas, no padrão ISO 4217, ex.: `BRL`.
</ResponseField>

```json Resposta theme={null}
{
  "id": "98acc0d1-332d-3bf8-92ab-202a2140a58a",
  "name": "Loja Exemplo",
  "legal_name": "Loja Exemplo Comercio LTDA",
  "status": "approved",
  "merchant_codes": [
    { "code": "4440", "description": "Servicos" }
  ],
  "payment_methods": ["pix", "credit_card"],
  "currencies": ["BRL"]
}
```

## Erros

| Status | Quando acontece                   |
| ------ | --------------------------------- |
| `403`  | Chave de API ausente ou inválida. |
| `401`  | Conta não está aprovada.          |