Criar cobrança PIX (Integração) com valores por parcela

POST

/api/v2/movimentacao/{accountId}/pixCobrancaIntegracao

Igual à pixCobranca, mas dadosCobranca é uma lista (parcelas com valores diferentes) e regrasCobranca usa tipoJuros (sem frequenciaCobranca/quantidadeParcelas).

Requisição

Parâmetros de Caminho

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢201Criado

application/json

Cobranças criadas (uma transação por parcela)

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠422UnprocessableEntity

🔴500ServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v2/movimentacao//pixCobrancaIntegracao' \
--header 'Content-Type: application/json' \
--data '{
    "dadosCobranca": [
        {
            "valorTotal": 55,
            "dataVencimento": "2026-02-20",
            "codigoExterno": "0012656",
            "conteudo": "Cobrança 1"
        },
        {
            "valorTotal": 45,
            "dataVencimento": "2026-03-20",
            "codigoExterno": "0345456",
            "conteudo": "Cobrança 2"
        }
    ],
    "pagador": {
        "cpfCnpj": "22.317.952/0001-76",
        "nomeFantasia": "InovaTech",
        "nomePagador": "Inova Sistemas Digitais Ltda",
        "cidade": "Rio de Janeiro",
        "uf": "RJ",
        "cep": "22640020"
    },
    "regrasCobranca": {
        "juros": 1,
        "multa": 2,
        "tipoMulta": "PERCENTUAL",
        "tipoJuros": "PERCENTUAL_MES_DIAS_UTEIS"
    },
    "urlCallBack": "https://meusite.com/api/pix/callback"
}'

Response Example

201 - Sucesso

{
    "data": {
        "transactions": [
            {
                "transactionId": "DE76B718-659F-CE2B-0E5F-F427548CE027",
                "financialStatement": {
                    "status": "CREATED"
                },
                "instantPayment": {
                    "textContent": "000201...63048DA7",
                    "dynamicQrCodeType": "BILLING_DUE_DATE"
                },
                "cobranca": {
                    "numeroDocumento": 2476,
                    "vencimento": "2026-02-20",
                    "valor": 55,
                    "numeroParcela": 1,
                    "totalParcelas": 2
                }
            }
        ]
    }
}

Modificado em 2026-07-15 14:29:20

Página anterior

Devolução (Refund) de uma transação PIX aprovada

Próxima página

Inativar cobrança com vencimento