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/invoicesaceitaasaas_installment_count(1–12) para parcelar no cartão de crédito via gateway Asaas. - Requisitos: ter um gateway
asaashabilitado (payment_gateway_idouenabled_gateways) e incluircredit_cardemasaas_payment_methods. - Se
asaas_installment_count > 1sem um gateway Asaas habilitado, a API retorna422. - 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; ostore()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