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

# Listar Campos Personalizados

> Lista os campos do checkout da loja, ou só os que valem para os produtos informados, com o id usado no pedido.

Lista os campos que o cliente preenche no checkout (como o Player ID). Use o `id` de cada campo para enviar o valor em [Criar Pedido](/api-reference/orders/create).

**Método:** `GET /api/v1/stores/me/custom-fields`

**Autenticação:** Obrigatória. Inclua o header `Authorization: Bearer sk_live_sua_api_key`. Escopo necessário: `catalog.read`.

## Parâmetros de consulta

<ParamField query="productIds" type="string">
  UUIDs de produtos separados por vírgula (até 100). Com ele, a resposta traz só os campos que valem para esses produtos: os vinculados ao produto, à categoria dele ou a todos os produtos. Sem ele, traz todos os campos da loja.
</ParamField>

## Exemplo de requisição

Os campos que o cliente precisa preencher para comprar um produto:

```bash theme={null}
curl -X GET 'https://api.bukiopay.com/api/v1/stores/me/custom-fields?productIds=c3b4168f-d732-44ed-8c67-6080cec06b09' \
  --header 'Authorization: Bearer sk_live_sua_api_key'
```

## Resposta

```json theme={null}
{
  "customFields": [
    {
      "id": "6f1d2c3b-4a5e-4f60-8a7b-9c0d1e2f3a4b",
      "label": "Player ID",
      "type": "NUMBER",
      "placeholder": "Seu ID no Free Fire",
      "required": true,
      "allProducts": false,
      "products": ["c3b4168f-d732-44ed-8c67-6080cec06b09"],
      "categories": [],
      "min": null,
      "max": null,
      "position": 0
    }
  ]
}
```

## Campos

<ResponseField name="id" type="string">
  Identificador do campo. É a chave do valor em `customFields` no pedido.
</ResponseField>

<ResponseField name="required" type="boolean">
  `true`: o pedido não é criado sem o valor.
</ResponseField>

<ResponseField name="type" type="string">
  `TEXT`, `NUMBER`, `EMAIL` ou `ROBLOX`.
</ResponseField>

<ResponseField name="products" type="string[]">
  Produtos em que o campo aparece. `categories` e `allProducts` ampliam a lista.
</ResponseField>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.