Criar cobrança PIX (Pix Cobrança) Integração

Em desenvolvimento

POST

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

Cria uma cobrança PIX com data de vencimento, regras de juros/multa e dados detalhados do pagador, gerando o QR Code para pagamento.
Com essa API é possível lançar mensalidades com valores diferentes em cada carnê.

Requisição

Parâmetros de Caminho

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢201Criado

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/v2/movimentacao//pixCobrancaIntegracao' \
--header 'Content-Type: application/json' \
--data-raw '{
    "dadosCobranca": [
        {
            "valorTotal": 55.00,
            "dataVencimento": "2026-02-20",
            "codigoExterno": "0012656",
            "conteudo": "Cobrança 1"
        },
        {
            "valorTotal": 45.00,
            "dataVencimento": "2026-03-20",
            "codigoExterno": "0345456",
            "conteudo": "Cobrança 2"
        }
    ],
    "pagador": {
        "cpfCnpj": "22.317.952/0001-76",
        "razaoSocial": "Inova Sistemas Digitais Ltda",
        "nomeFantasia": "InovaTech",
        "segmento": "Desenvolvimento de Software",
        "email": "contato@inovatech.com.br",
        "telefoneCelular": "+55 21 98877-4455",
        "nomePagador": "Inova Sistemas Digitais Ltda",
        "logradouro": "Avenida das Américas, 3500",
        "cidade": "Rio de Janeiro",
        "bairro": "Barra da Tijuca",
        "uf": "RJ",
        "cep": "22640020"
    },
    "regrasCobranca": {
        "juros": 1.0,
        "multa": 2.0,
        "tipoMulta": "PERCENTUAL",
        "tipoJuros": "PERCENTUAL_MES_DIAS_CORRIDOS"
    },
    "urlCallBack": "https://eou7tvxmkajry8k.m.pipedream.net"
}'

Response Example

{
    "data": {
        "transactions": [
            {
                "transactionId": "DE76B718-659F-CE2B-0E5F-F427548CE027",
                "externalIdentifier": "0012656",
                "financialStatement": {
                    "status": "CREATED"
                },
                "transactionDate": "2026-02-10T10:38:35.741-03:00",
                "transactionType": "InstantPayment",
                "totalAmount": 55.00,
                "paidAmount": 55.0,
                "instantPayment": {
                    "textContent": "00020101021226990014br.gov.bcb.pix2577pix-h.bpp.com.br/23114447/qrs1/v2/cobv/013AAqH6E4TnWeKG8Z2NZyVo8a6cgl8xbgi52c520400005303986540555.005802BR5923Leandro de S Nascimento6010MAE DO RIO62070503***63048DA7",
                    "reference": "QRS1TXRIPMPB9HSVD58GMJNZ3DFANTO5MHF",
                    "qrcodeURL": "https://pix-h.bpp.com.br/23114447/qrs1/v2/cobv/013AAqH6E4TnWeKG8Z2NZyVo8a6cgl8xbgi52c",
                    "dynamicQrCodeType": "BILLING_DUE_DATE"
                },
                "cobranca": {
                    "numeroDocumento": 2476,
                    "codigoExternoIntegrador": "0012656",
                    "emissao": "2026-02-10",
                    "vencimento": "2026-02-20",
                    "valor": 55.00,
                    "numeroParcela": 1,
                    "totalParcelas": 2,
                    "juros": 1.0,
                    "multa": 2.0,
                    "tipoMulta": "PERCENTUAL",
                    "tipoJuros": "PERCENTUAL_MES_DIAS_CORRIDOS",
                    "cpfCnpj": "32647326000100",
                    "instrucoesAdicionais": "Cobrança 1",
                    "outrasInformacoes": "Cobrança 1",
                    "documento": {
                        "link": "https://api-hml.lcpay.com.br/api/v2/movimentacao/download/inv_2c718f21-1829-44dc-bc57-7de52c5f64aa.pdf"
                    }
                }
            },
            {
                "transactionId": "2C1CF84B-9D97-7C34-2E15-51188D2427F3",
                "externalIdentifier": "0345456",
                "financialStatement": {
                    "status": "CREATED"
                },
                "transactionDate": "2026-02-10T10:38:38.445-03:00",
                "transactionType": "InstantPayment",
                "totalAmount": 45.00,
                "paidAmount": 45.0,
                "instantPayment": {
                    "textContent": "00020101021226990014br.gov.bcb.pix2577pix-h.bpp.com.br/23114447/qrs1/v2/cobv/01Q7OdEsR25CjorJAOAd2uRiWO91JCK73oZNwo520400005303986540545.005802BR5923Leandro de S Nascimento6010MAE DO RIO62070503***63045CD2",
                    "reference": "QRS1TXAIUCAPK86DBTWNOG9NZ58GW4JDMHW",
                    "qrcodeURL": "https://pix-h.bpp.com.br/23114447/qrs1/v2/cobv/01Q7OdEsR25CjorJAOAd2uRiWO91JCK73oZNwo",
                    "dynamicQrCodeType": "BILLING_DUE_DATE"
                },
                "cobranca": {
                    "numeroDocumento": 2477,
                    "codigoExternoIntegrador": "0345456",
                    "emissao": "2026-02-10",
                    "vencimento": "2026-03-20",
                    "valor": 45.00,
                    "numeroParcela": 2,
                    "totalParcelas": 2,
                    "juros": 1.0,
                    "multa": 2.0,
                    "tipoMulta": "PERCENTUAL",
                    "cpfCnpj": "32647326000100",
                    "instrucoesAdicionais": "Cobrança 2",
                    "outrasInformacoes": "Cobrança 2",
                    "documento": {
                        "link": "https://api-hml.lcpay.com.br/api/v2/movimentacao/download/inv_2c718f21-1829-44dc-bc57-7de52c5f64aa.pdf"
                    }
                }
            }
        ]
    }
}

Modificado em 2026-02-13 14:08:01