Atualizar Campo Personalizado

Atualiza um campo do checkout. Envie apenas o que quer mudar; o resto continua como está. Método: PUT /api/v1/stores/me/custom-fields/:id Autenticação: Obrigatória. Inclua o header Authorization: Bearer sk_live_sua_api_key. A chave precisa ter a permissão Tudo (*).

Parâmetros de caminho

string

required

UUID do campo.

Parâmetros do corpo

Os mesmos de Criar Campo, todos opcionais: label, type, required, products, categories, allProducts, placeholder, min, max e position.

products e categories substituem a lista inteira. Para incluir um produto, envie a lista com os que já estavam e o novo.

Exemplo de requisição

Vincular o Player ID a mais um produto:

curl -X PUT 'https://api.bukiopay.com/api/v1/stores/me/custom-fields/6f1d2c3b-4a5e-4f60-8a7b-9c0d1e2f3a4b' \
  --header 'Authorization: Bearer sk_live_sua_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "products": [
      "c3b4168f-d732-44ed-8c67-6080cec06b09",
      "9d40e409-28e6-481f-aafc-83f97b831f07"
    ]
  }'

Resposta

{
  "customField": {
    "id": "6f1d2c3b-4a5e-4f60-8a7b-9c0d1e2f3a4b",
    "label": "Player ID",
    "type": "NUMBER",
    "required": true,
    "products": [
      "c3b4168f-d732-44ed-8c67-6080cec06b09",
      "9d40e409-28e6-481f-aafc-83f97b831f07"
    ]
  }
}

A resposta traz o campo completo, com os mesmos dados de Listar Campos.

Erros comuns

Status	Mensagem	Causa
`400`	Nada para atualizar.	Corpo vazio.
`400`	ID do campo inválido.	O `id` não é um UUID.
`404`	Campo não encontrado	O campo não existe ou é de outra loja.

Introdução à API

Cobranças PIX

Saques

Webhooks

Pedidos

Produtos

Campos Personalizados

Categorias

Cupons

Loja

Atualizar Campo Personalizado

Parâmetros de caminho

Parâmetros do corpo

Exemplo de requisição

Resposta

Erros comuns

​Parâmetros de caminho

​Parâmetros do corpo

​Exemplo de requisição

​Resposta

​Erros comuns

Parâmetros de caminho

Parâmetros do corpo

Exemplo de requisição

Resposta

Erros comuns