API — Parcelamento e recorrência de faturas (cartão Asaas suportado)

Parcelamento no CARTÃO DE CRÉDITO é suportado na API via asaas_installment_count (1–12) com gateway Asaas habilitado. Já o carnê (parcelar boleto) e as faturas recorrentes NÃO são suportados via API — use a interface web ou crie várias faturas com vencimentos diferentes.

API — Parcelamento e recorrência de faturas

Resposta direta para dúvidas sobre parcelamento (parcelas, installments, cartão, carnê) e recorrência de faturas na API REST /api/v1.

Parcelamento no cartão de crédito: SUPORTADO (via Asaas)

  • O POST /api/v1/invoices aceita asaas_installment_count (1–12) para parcelar no cartão de crédito via gateway Asaas.
  • Requisitos: ter um gateway asaas habilitado (payment_gateway_id ou enabled_gateways) e incluir credit_card em asaas_payment_methods.
  • Se asaas_installment_count > 1 sem um gateway Asaas habilitado, a API retorna 422.
  • O mesmo vale no PUT /api/v1/invoices/{id}.
POST /api/v1/invoices
{
  "contact_id": 1,
  "due_date": "2026-04-30",
  "payment_gateway_id": 3,
  "enabled_gateways": [3],
  "asaas_installment_count": 3,
  "asaas_payment_methods": ["credit_card", "pix"],
  "items": [ { "name": "Plano Anual", "quantity": 1, "unit_price": 1200 } ]
}

Carnê (parcelar boleto): NÃO suportado via API

  • Não há recurso de carnê (dividir um boleto em várias parcelas) na API.
  • Existe apenas na interface web. Para simular via API, crie várias faturas com vencimentos diferentes (cada parcela é uma fatura independente).

Faturas recorrentes: NÃO suportado via API

  • O campo is_recurring é apenas leitura/filtro; o store() da API não cria recorrência.
  • Crie recorrências pela interface web.

Detalhes completos no artigo "API — Faturas e Pagamentos (/invoices)".

api parcelamento installments cartão asaas carnê recorrente faturas

Este artigo foi útil?

Artigos Relacionados