Cada plano de parcelamento é uma linha na tabela Opções de parcelamento dentro da tela do gateway (em WooCommerce > Configurações > Pagamentos > Boleto Parcelado). Você cria quantos quiser, e cada um tem um valor mínimo de carrinho pra aparecer no checkout.
Campos de cada plano
| Coluna | Descrição |
|---|---|
| Código | Identificador interno do plano (ex.: 3X, 6X, PLAN_12). Salvo no pedido em _ticket_installments_code. Use sanitize_key — só letras, números, hífen e underline. |
| Descrição | Texto exibido pro cliente no checkout (ex.: 3x de R$ 100,00 sem juros). |
| Compra mínima | Subtotal mínimo do carrinho pra esse plano aparecer (em moeda da loja, sem símbolo). |
Adicionando um plano
- Clique em + Adicionar opção. Uma linha vazia aparece na tabela.
- Preencha Código, Descrição e Compra mínima.
- Salvar alterações.
Você pode arrastar pelo handle à esquerda pra reordenar e usar Remover selecionado(s) pra apagar.
Exemplo
Código: 3X
Descrição: 3x de R$ 100,00 (total R$ 300,00)
Compra mínima: 300
Código: 6X
Descrição: 6x de R$ 100,00 (total R$ 600,00)
Compra mínima: 600
Código: 12X
Descrição: 12x de R$ 100,00 (total R$ 1.200,00)
Compra mínima: 1200
Com essa configuração:
- Carrinho de R$ 250 → método não aparece (abaixo do menor mínimo).
- Carrinho de R$ 350 → cliente vê só o plano
3X. - Carrinho de R$ 700 → cliente vê
3Xe6X. - Carrinho de R$ 1.500 → cliente vê os três.
O que o cliente vê
No checkout, os planos compatíveis aparecem como botões de rádio com o texto da Descrição. O Código é só interno — o cliente nunca vê.
A Descrição é o que vende a opção. Inclua quantas parcelas, valor de cada uma, total e se tem juros. Exemplo: 6x de R$ 100,00 - Total R$ 600,00 - Sem juros.
Override pelo Simulador de Parcelas
Se você ativar a integração com o Simulador de Parcelas, os planos manuais desta tabela são ignorados e os planos exibidos no checkout passam a ser calculados dinamicamente pelo Simulador.
Com a integração ativa, qualquer alteração que você fizer aqui não tem efeito no checkout. Pra voltar a usar planos manuais, desmarque Integração com Simulador de parcelas.
Onde os planos ficam salvos
A tabela é salva como uma única opção do WordPress: wc_ticket_installments_available_options. Pra acessar via código:
$options = get_option( 'wc_ticket_installments_available_options' );
// [
// ['payment_code' => '3X', 'payment_description' => '...', 'payment_minimum' => 300],
// ...
// ]
Pra customizar o que aparece no checkout sem mexer na tabela, use o filtro woocommerce_wc_ticket_gateway_installments_available.