Listar Campos Personalizados

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. 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

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.

Exemplo de requisição

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

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

{
  "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

string

Identificador do campo. É a chave do valor em customFields no pedido.

boolean

true: o pedido não é criado sem o valor.

string

TEXT, NUMBER, EMAIL ou ROBLOX.

string[]

Produtos em que o campo aparece. categories e allProducts ampliam a lista.

Introdução à API

Cobranças PIX

Saques

Webhooks

Pedidos

Produtos

Campos Personalizados

Categorias

Cupons

Loja

Listar Campos Personalizados

Parâmetros de consulta

Exemplo de requisição

Resposta

Campos

​Parâmetros de consulta

​Exemplo de requisição

​Resposta

​Campos

Parâmetros de consulta

Exemplo de requisição

Resposta

Campos