Criar cobrança PIX (Pix Cobrança) com vencimento

POST

/api/v2/movimentacao/{accountId}/pixCobranca

Cria uma cobrança com vencimento; valorTotal é o mesmo em todas as parcelas. Aplica Bean Validation (retorna 400 com a primeira violação).

Requisição

Parâmetros de Caminho

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200Sucesso

application/json

Cobrança criada (lista de recibos)

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠422UnprocessableEntity

🔴500ServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v2/movimentacao//pixCobranca' \
--header 'Content-Type: application/json' \
--data-raw '{
    "dadosCobranca": {
        "valorTotal": 55,
        "dataVencimento": "2026-02-20",
        "codigoExterno": "00123456",
        "conteudo": "Cobrança 0000"
    },
    "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,
        "multa": 2,
        "frequenciaCobranca": "MENSAL",
        "tipoMulta": "PERCENTUAL",
        "quantidadeParcelas": 1
    },
    "urlCallBack": "https://meusite.com/api/pix/callback"
}'

Response Example

200 - Sucesso

{
    "reciboPagador": {
        "numeroDocumento": 2440,
        "vencimento": "2026-02-20",
        "valor": 55,
        "numeroParcela": 1,
        "totalParcelas": 1
    },
    "pagamentoPix": {
        "transacaoId": "6A5A7118-D74A-18A6-1FE7-B7105FAEE5A6",
        "numeroDocumento": 2440,
        "documento": {
            "link": "https://api-hml.lcpay.com.br/api/v2/movimentacao/download/inv_47acb34a.pdf"
        }
    }
}

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

Página anterior

Criar intenção de pagamento (PIX Dinâmico)

Próxima página

Consultar status da transação