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

POST

/api/v2/movimentacao/{accountId}/pixCashIn

Cria uma intenção de pagamento PIX dinâmico (imediato). Informe urlCallBackIntegrador para receber a notificação de pagamento por webhook. Este endpoint NÃO aplica Bean Validation — valores inválidos tendem a resultar em 500.

Requisição

Parâmetros de Caminho

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200

application/json

Intenção de pagamento criada (QR Code)

Bodyapplication/json

🟠401

🟠403

🟠404

🟠422

🔴500ServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api-hml.lcpay.com.br/api/v2/movimentacao/236BD098-F481-48D6-6F7F-A357E09DEB45/pixCashIn' \
--header 'Content-Type: application/json' \
--data '{
    "valorTotal": 18,
    "numeroPedido": "ID3455",
    "conteudo": "ID123",
    "urlCallBackIntegrador": "https://seu-sistema.com.br/webhooks/pix"
}'

Response Example

200 - Sucesso

{
    "data": {
        "transactionId": "E37CFF03-76F2-102A-9F42-C58AA360804F",
        "financialStatement": {
            "status": "CREATED"
        },
        "transactionType": "InstantPayment",
        "totalAmount": 18,
        "instantPayment": {
            "textContent": "00020101021226990014br.gov.bcb.pix...6304C290",
            "qrcodeURL": "https://pix-h.bpp.com.br/23114447/qrs1/v2/...",
            "generateImage": {
                "imageContent": "iVBORw0KGgo... (base64 PNG)",
                "mimeType": "image/png"
            },
            "dynamicQrCodeType": "IMMEDIATE"
        }
    }
}

Modificado em 2026-07-16 13:53:02

Página anterior

Fluxos de Integração — Emissão de Pagamentos (PIX)

Próxima página

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