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

POST

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

Cria uma nova intenção de pagamento PIX dinâmico, retornando os dados do QR Code (imagem Base64 e código copia e cola).

Requisição

Authorization

JWT Bearer

Adicionar o parâmetro

Authorization

a Cabeçalhos

Exemplo:

Authorization: ********************

Parâmetros de Caminho

Parâmetros Header

Parâmetros Bodyapplication/json

Examples

Respostas

🟢200

application/json

Sucesso

Bodyapplication/json

🟠400

🟠401

🟠403

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v2/movimentacao/133BD098-F481-48D6-6F7F-A357E09DEB45/pixCashIn' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "valorTotal": 18,
    "numeroPedido": "ID3455",
    "conteudo": "ID123"
}'

Response Example

200 - Sucesso

{
    "data": {
        "transactionId": "E37CFF03-76F2-102A-9F42-C58AA360804F",
        "externalIdentifier": "e520a57a-49c7-43e4-91cf-65333311baa9",
        "financialStatement": {
            "status": "CREATED"
        },
        "transactionDate": "2025-10-02T09:34:02.843-03:00",
        "transactionType": "InstantPayment",
        "totalAmount": 18,
        "paidAmount": 18,
        "instantPayment": {
            "textContent": "00020101021226990014br.gov.bcb.pix2577pix-h.bpp.com.br/23114447/qrs1/v2/01fETAF1UxHuMwWbqgNNLoArNIbKSRJxrnq2AkYKruQ520400005303986540518.005802BR5923Leandro de S Nascimento6009SAO PAULO62070503***6304C290",
            "reference": "QRS1TXYUEPNGWZS0MMSIPFST9L1S1HBJWEY",
            "qrcodeURL": "https://pix-h.bpp.com.br/23114447/qrs1/v2/01fETAF1UxHuMwWbqgNNLoArNIbKSRJxrnq2AkYKruQ",
            "generateImage": {
                "imageContent": "ivbbiU6yXHRYSR0X5/BSd0uns17k1vv8GZ7F1yR0tt...",
                "mimeType": "image/png",
                "actualImageWidth": 400
            },
            "dynamicQrCodeType": "IMMEDIATE"
        }
    }
}

Modificado em 2026-07-14 19:44:54

Página anterior

URLs Produção e Homologação

Próxima página

Criar cobrança PIX (Pix Cobrança)