Campos personalizados: documentação do CheckoutOS

Os campos personalizados permitem coletar informações adicionais dos clientes no checkout. Esses dados podem ser usados para personalização, requisitos de preparação dos pedidos, conformidade regulatória ou marketing.

Use com moderação

Cada campo adicional dificulta um pouco o checkout. Colete apenas informações realmente necessárias. Cada campo obrigatório pode reduzir a conversão em 1–3%.

Tipos de campos disponíveis

Campos de texto

Tipos de entrada de texto

Texto de uma linha — Respostas curtas
Área de texto com várias linhas — Respostas mais longas, como instruções
E-mail — Com validação
Número de telefone — Com formatação
Número — Entrada apenas numérica

Campos de seleção

Tipos de seleção

Lista suspensa — Uma escolha em uma lista
Botões de opção — Uma escolha, com todas as opções visíveis
Caixas de seleção — Permitem várias escolhas
Interruptor — Escolha binária de sim ou não

Campos especiais

Tipos de entrada especiais

Seletor de data — Seleção no calendário
Seletor de horário — Seleção de faixa de horário
Envio de arquivo — Envio de documentos e imagens
Assinatura — Captura de assinatura digital

Casos de uso comuns

Instruções de entrega

Campo de instruções de entrega

{
  "field": {
    "id": "delivery_instructions",
    "type": "textarea",
    "label": "Delivery Instructions",
    "placeholder": "Gate code, leave at door, etc.",
    "required": false,
    "max_length": 200,
    "placement": "shipping_address"
  }
}

Verificação de idade

Campo de verificação de idade

{
  "field": {
    "id": "age_verification",
    "type": "date",
    "label": "Date of Birth",
    "required": true,
    "validation": {
      "min_age": 21,
      "error_message": "You must be 21 or older to purchase this product"
    },
    "conditional": {
      "show_when": "cart_contains_tag",
      "tag": "age-restricted"
    }
  }
}

Informações empresariais e fiscais

Campos empresariais

{
  "fields": [
    {
      "id": "company_name",
      "type": "text",
      "label": "Company Name",
      "required": false
    },
    {
      "id": "vat_number",
      "type": "text",
      "label": "VAT Number",
      "required": false,
      "validation": "vat",
      "conditional": {
        "show_when": "country_in",
        "countries": ["DE", "FR", "IT", "ES", "NL"]
      }
    }
  ]
}

Personalização de produtos

Campos de personalização

{
  "field": {
    "id": "engraving_text",
    "type": "text",
    "label": "Engraving Text",
    "placeholder": "Enter text to engrave (max 20 characters)",
    "required": true,
    "max_length": 20,
    "conditional": {
      "show_when": "cart_contains_product",
      "product_ids": ["ring-001", "bracelet-002"]
    }
  }
}

Configuração de campos personalizados

Crie um campo

Acesse CheckoutOS → Checkout Extensions → Custom Fields → Add Field.

Selecione o tipo de campo

Escolha o tipo de entrada adequado aos dados.

Configure as propriedades

Defina rótulo, texto de exemplo, regras de validação e requisitos.

Defina condições (opcional)

Defina quando o campo aparece com base no carrinho ou no cliente.

Escolha o posicionamento

Selecione onde o campo aparece no checkout.

Mapeie o destino dos dados

Configure onde os dados coletados são armazenados e enviados.

Opções de validação

Garanta a qualidade dos dados com a validação integrada:

Configuração de validação

{
  "validation": {
    "required": true,
    "min_length": 2,
    "max_length": 100,
    "pattern": "^[A-Za-z ]+$",
    "pattern_message": "Only letters and spaces allowed",
    "custom_validator": "validate_phone_number",
    "validate_on": "blur"
  }
}

Exibição condicional

Mostre campos apenas quando as condições relevantes forem atendidas:

Lógica condicional

{
  "conditions": {
    "logic": "AND",
    "rules": [
      {
        "type": "cart_total",
        "operator": "greater_than",
        "value": 100
      },
      {
        "type": "shipping_country",
        "operator": "in",
        "value": ["US", "CA"]
      }
    ]
  }
}

Tratamento de dados

Os dados de campos personalizados podem ser enviados a vários destinos:

Destinos dos dados

Atributos do pedido na Shopify — Visíveis na administração do pedido
Notas do pedido na Shopify — Combinados no campo de notas
Metacampos da Shopify — Armazenamento estruturado de dados
Webhooks — Envio a sistemas externos
E-mail — Inclusão na confirmação do pedido
Apps de preparação de pedidos — ShipStation e outros

Tratamento de informações pessoais

Se coletar informações pessoais sensíveis (SSN, dados de saúde etc.), garanta que o tratamento cumpra as normas aplicáveis (GDPR, CCPA, HIPAA). Considere criptografia e controles de acesso.

Estilo dos campos personalizados

Estilo dos campos

{
  "styling": {
    "label_position": "above",
    "label_size": "small",
    "input_style": "outlined",
    "error_style": "inline",
    "help_text_position": "below",
    "required_indicator": "*",
    "group_fields": true,
    "group_title": "Additional Information"
  }
}

Boas práticas

Dicas de otimização

Minimize os campos obrigatórios — Cada campo dificulta um pouco o processo
Use exibição condicional — Mostre apenas campos relevantes
Use rótulos claros — O usuário deve saber por que você pede a informação
Use tipos de campo adequados — Seletores para datas e listas suspensas para opções fixas
Defina padrões sensatos — Preencha previamente quando possível
Teste no celular — Garanta bom funcionamento em dispositivos sensíveis ao toque

Tópicos relacionados

Visão geral das extensões de checkout

Veja todas as extensões disponíveis

Saiba mais

Funções de desconto

Aplique descontos com base nos valores dos campos

Saiba mais