Pagamentos e impostos

Duas configurações da loja têm rotas próprias na API compatível com a Venddor 1.0. As formas de pagamento definem o que o cliente pode escolher no checkout (Pix, boleto, cartão, pagamento na entrega). As regras de imposto são os cadastros de imposto que a loja aplica aos produtos. Um ERP ou um painel externo usa estas rotas para espelhar essa configuração ou para criá-la sem abrir o painel.

Como funciona

1. Leia o que a loja já tem

   GET /payments e GET /taxes devolvem os cadastros em páginas.

2. Crie ou ajuste

   Crie uma forma de pagamento com POST /payments e altere com PUT /payments/{id}. As regras de imposto seguem o mesmo desenho.

3. Desative em vez de apagar

   Mude o status para D quando só quiser tirar uma opção do checkout. Apague apenas o que nunca foi usado.

Conceitos

Status

Na escrita de formas de pagamento, A, active e enabled ativam; qualquer outro valor desativa. Nas regras de imposto, qualquer valor diferente de D deixa a regra ativa.

Tipo de processamento

Toda forma de pagamento tem um tipo (venddor_processor_type): online (gateway, como Pix e cartão), offline (pagamento na entrega, transferência) ou invoiced (boleto faturado, com parcelas). O campo processor_type, por compatibilidade, vale sempre P.

Rotas

Erros comuns

• Esperar as credenciais do gateway na leitura. Elas são sempre removidas de processor_params. Para trocar uma credencial, grave de novo pelo PUT.
• Mandar status: "active" em imposto. Em regras de imposto só D desativa; qualquer outro valor deixa a regra ativa.
• Confundir os dois tipos de id. O id da forma de pagamento é UUID; o id da regra de imposto é um inteiro.
• Esperar paginação do servidor em /taxes. A lista traz todas as regras; page e items_per_page só aparecem como eco em params.

Próximos passos