> ## Documentation Index
> Fetch the complete documentation index at: https://docs.invo.work/llms.txt
> Use this file to discover all available pages before exploring further.

# Pagamentos

> Como informar a forma de pagamento da NF-e (grupo YA) e atender à IN SEFAZ-CE nº 87/2025.

O campo `pagamentos` informa como o cliente pagou a nota. A Invo leva esses dados ao grupo de pagamento do XML (grupo YA, `detPag`) sem alterá-los. O campo é opcional e vale para `POST /notas` da API NF-e.

## Quando informar

* Sem `pagamentos`, a nota sai como "sem pagamento" (`tPag=90`). Esse é o caso do faturamento entre empresas. Integrações que não mandam o campo continuam iguais.
* Com `pagamentos`, informe cada forma de pagamento da venda. Uma nota aceita várias formas, por exemplo parte em dinheiro e parte em cartão.

<Info>
  No Ceará, a IN SEFAZ-CE nº 87/2025 exige que a venda com cartão ou PIX leve os dados da transação na NF-e e na NFC-e. O prazo depende do grupo da empresa. Para os demais varejistas (Grupo 3), vale a partir de 03/11/2026. Estão dispensados: MEI, Nota Fiscal Fácil, delivery com pagamento na entrega, venda em marketplace de terceiros, PIX estático, pagamento sem código de autorização individual e venda para contribuinte do ICMS.
</Info>

## Exemplo

Venda de R\$ 150,00 no cartão de crédito, com o pagamento integrado ao PDV:

```json theme={null}
{
  "pagamentos": [
    {
      "forma_pagamento": "03",
      "valor": "150.00",
      "indicador_pagamento": 0,
      "cartao": {
        "tipo_integracao": 1,
        "cnpj_credenciadora": "01027058000191",
        "bandeira": "02",
        "codigo_autorizacao": "A12345",
        "id_terminal": "TERM001"
      }
    }
  ],
  "troco": "0.00"
}
```

Os demais campos da nota (destinatário, itens etc.) seguem iguais. A referência do endpoint [Emitir Nota de Produto (NF-e)](/api-reference/notas-de-produto/emitir-nota-de-produto-nf-e), na aba API NF-e, lista todos os campos e os códigos de `forma_pagamento` e `bandeira`.

## Regras

A Invo confere o payload na criação da nota. Se uma regra falhar, a API responde `422` e não cria a nota.

| Regra | Detalhe |
| - | - |
| A soma fecha com o total | A soma de `valor` deve ser igual ao total da nota mais o `troco`. |
| `90` fica sozinho | A forma `90` (sem pagamento) não aparece com outras formas e exige `valor` zero. |
| Cartão obrigatório | As formas `03` (crédito), `04` (débito) e `17` (PIX dinâmico) exigem o grupo `cartao`. |
| Cartão só onde a SEFAZ aceita | O grupo `cartao` só vale nas formas `03`, `04`, `10`, `11`, `12`, `13`, `15`, `17`, `18`, `23` e `24`. |
| Descrição em `99` | A forma `99` (outros) exige `descricao`, com 2 a 60 caracteres. |
| CNPJ e UF juntos | Informe `cnpj_transacional` e `uf_transacional` juntos, ou nenhum dos dois. |
| Troco com pagamento | O `troco` exige ao menos uma forma de pagamento. |
| Data | `data` usa o formato `AAAA-MM-DD`. |

## Conformidade no Ceará

Para as vendas alcançadas pela IN 87, envie no grupo `cartao`:

* `tipo_integracao: 1`: o pagamento passou pelo sistema de automação, como TEF ou POS integrado.
* `cnpj_credenciadora`: o CNPJ da instituição de pagamento.
* `codigo_autorizacao`: o código de autorização do comprovante. No PIX dinâmico, use o identificador da transação (e2eid).
* `id_terminal`: o identificador do terminal, quando houver.

Se o pagamento foi processado em outro estabelecimento, informe também `cnpj_transacional` e `uf_transacional`.

<Note>
  A Invo aceita `tipo_integracao: 2` (POS não integrado), porque esse valor é válido nas vendas dispensadas. A Invo não sabe se a sua venda está dispensada. A escolha do valor certo é do seu PDV.
</Note>

## Venda em marketplace

Quando a venda passa por um intermediador, informe o campo `intermediador`. O intermediador é o site ou a plataforma de terceiros onde a venda aconteceu, como um marketplace. A Invo leva os dados ao XML: `indIntermed=1` na identificação da nota e o grupo `infIntermed` (grupo YB).

```json theme={null}
{
  "indicador_presenca": 2,
  "intermediador": {
    "cnpj": "03995515001309",
    "identificador_cadastro": "LOJA123"
  }
}
```

* `cnpj`: o CNPJ do intermediador. A Invo aceita o CNPJ com ou sem máscara e confere o dígito verificador.
* `identificador_cadastro`: o seu nome de usuário ou o seu perfil de vendedor no intermediador. O valor tem de 2 a 60 caracteres. A Invo envia o valor sem alteração, então ele não pode ter espaço nas pontas, tab ou quebra de linha.
* `indicador_presenca`: é obrigatório quando há intermediador e deve ser `1`, `2`, `3`, `4` ou `9`.

<Info>
  No Ceará, a IN 87 dispensa a vinculação do pagamento na venda não presencial feita por um intermediador. Na NF-e, a dispensa exige `indicador_presenca` `2` (internet) ou `3` (teleatendimento), além do `intermediador`. Com `indicador_presenca: 9`, a nota sai válida, mas não atende à dispensa.
</Info>

Se o intermediador processa o pagamento, a IN 87 manda informar o CNPJ dele em `cartao.cnpj_credenciadora`.

## Na resposta

As respostas de `POST /notas`, `GET /notas` e `GET /notas/{id}` trazem `pagamentos`, `troco` e `intermediador`. Uma venda sem intermediador retorna `"intermediador": null`. Uma nota sem pagamento informado retorna `"pagamentos": []` e `"troco": "0.0"`. Quando a forma não tem grupo cartão, o item de `pagamentos` traz `"cartao": null`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.