Erros comuns e boas práticas

Erros comuns

1. Campos obrigatórios ausentes

{
   "errors": [
       {
           "code": "invalid_object",
           "description": "O campo items deve ser informado."
       }
   ]
}

Como evitar: Sempre preencha os campos obrigatórios:

• billingTypes
• chargeTypes
• callback com cancelUrl, expiredUrl, successUrl
• items com name, description, value, quantity

Boas Práticas

Organização e clareza — Estruture suas requisições com indentação clara e nomeie bem seus itens (name, description) — isso ajuda na conversão e na visualização.

Segurança — Mantenha seu access_token seguro e nunca exponha em repositórios públicos.

Testes e ambiente sandbox — Use o ambiente de testes para validar integrações antes de ir para produção.

Fluxo de expiração ajustado — Use minutesToExpire de forma estratégica.

Experiência do cliente — Envie imagens base64 nos itens do checkout para uma tela mais visual e profissional. Preencha customerData sempre que possível para agilizar o preenchimento dos dados do cliente.

Reaproveitamento — Cadastrou um cliente via API? Use o campo customer nas próximas vendas com esse mesmo comprador.

Validação de regras de negócio — Confira se sua lógica de chargeTypes e billingTypes está conforme as seguintes combinações válidas: