---
title: "Criar Qr Code Dinâmico"
method: POST
path: "/pix/indireto/qrcode/dinamico"
tags: ["QrCode"]
---

# Criar Qr Code Dinâmico

`POST /pix/indireto/qrcode/dinamico`

## Request

- Base URL: `https://example`
- URL: `https://example/pix/indireto/qrcode/dinamico`
- Auth: none required

Realiza a criação de um novo qr code dinâmico<br /><b>Caracteristicas:</b><br /><ul><li>Pode ser pago apenas uma vez;</li><li>Expira;</li><li>Deve ser parâmetrizado com um identificador único "txId" do cliente para fins de conciliação;</li><li>Ao ser pago dispara um webhook sob o evento "Recebimento" com o txId parametrizado;</li></ul>

## Headers

- `chaveIdempotencia` string, uuid
- `Authorization` string, required

## Request body

- Bs2Core2PixIndiretoQRCodeCobrancaAppApisForIntegrationQrCodeCriarQrCodeDinamicoImediatoCriarQrCodeDinamicoImediato
  - `recebedor` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosRecebedorDinamicoImediato, required
    - `codigoCategoria` string, nullable: Código da categoria do comerciante MCC ISO18245
    - `moeda` string, nullable: Código da moeda “986” – BRL: real brasileiro - ISO4217
    - `codigoPostal` string, nullable: CEP da localidade onde é efetuada a transação
    - `cidade` string, nullable: Cidade onde é efetuada a transação, no QRCode apresenta apenas os 15 primeiros caracteres.
    - `pessoa` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosPessoa, required
      - `nome` string, required: Nome do beneficiário/recebedor retornado na consulta DICT
      - `nomeFantasia` string, nullable
      - `documento` string, required: Documento da pessoa: CPF, CNPJ.
      - `tipo` 'PessoaFisica' | 'PessoaJuridica', required
    - `contaBancaria` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosContaBancaria, required
      - `agencia` string, nullable: Agência do cliente
      - `conta` string, required: Conta do cliente, com dígito
      - `tipo` 'Corrente' | 'Salario' | 'Poupanca' | 'Pagamento', required
  - `cobranca` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosCobranca, required
    - `transactionId` string, nullable: Identificador da transação, utilizado para fins de conciliação, se nao existir é gerado automaticamente
    - `solicitacaoPagador` string, nullable: Texto que será apresentado ao pagador para que ele preencha alguma informação destinada ao recebedor
    - `valor` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosValorCobranca, required
      - `valorOriginal` number, double, required: Valor da cobrança
      - `modalidadeAlteracao` 'NaoPermitida' | 'Permitida': 0 - NaoPermitida - Não permite alteração de valor 1 - Permitida - Permite alteração de valor
    - `calendario` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosCalendario, required
      - `expiracao` integer
    - `chave` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosChave, required: Tipo e valor da chave
      - `tipo` 'CPF' | 'CNPJ' | 'Telefone' | 'Email' | 'Aleatoria', required
      - `valor` string, required: >Caso seja do tipo PHONE, utilizar o código do país (iniciado por +), DDD e o número do telefone;<br></br> Caso seja do tipo CPF, somente 11 dígitos numéricos;<br></br> Caso seja CNPJ, somente 14 dígitos numéricos;<br></br> Caso seja email, deverá conter '@' e um '.'
    - `devedor` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosDevedorDinamicoImediato
      - `validaPagador` boolean
      - `pessoa` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosPessoa
        - `nome` string, required: Nome do beneficiário/recebedor retornado na consulta DICT
        - `nomeFantasia` string, nullable
        - `documento` string, required: Documento da pessoa: CPF, CNPJ.
        - `tipo` 'PessoaFisica' | 'PessoaJuridica', required
    - `informacoesAdicionais` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosInformacaoAdicional[], nullable
      - `nome` string, nullable: Nome do campo
      - `valor` string, nullable: Valor do campo
  - `retirada` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosRetirada
    - `ispb` string, required: ISPB do facilitador de serviço de saque (NR)
    - `valor` number, double
    - `modalidadeAlteracao` 'NaoPermitida' | 'Permitida', required: 0 - NaoPermitida - Não permite alteração de valor 1 - Permitida - Permite alteração de valor
    - `modalidadeAgente` 'FacilitadorDeServicoDeSaque' | 'EstabelecimentoComercial' | 'OutraEspeciePJouCorrespondenteNoPais', required
    - `finalidade` 'PixTroco' | 'PixSaque', required: 1 - PixTroco - Utilizado paga transações de pix - saque 2 - PixSaque - Utilizado paga transações de pix - troco

## Response `201`

Created

- Bs2Core2PixIndiretoQRCodeCobrancaAppApisForIntegrationQrCodeCriarQrCodeDinamicoImediatoQrCodeDinamicoImediatoCriado
  - `id` string, uuid
  - `status` 'Ativo' | 'Expirado' | 'Pago' | 'RemovidoPsp' | 'Vencido'
  - `revisao` integer
  - `dataCriacao` string, date-time
  - `qrCode` string, nullable
  - `valor` number, double, nullable
  - `location` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosLocation
    - `id` string, uuid
    - `location` string, nullable
    - `tipo` 'COB' | 'COBV'
    - `dataCriacao` string, date-time
  - `cobranca` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosCobranca
    - `transactionId` string, nullable: Identificador da transação, utilizado para fins de conciliação, se nao existir é gerado automaticamente
    - `solicitacaoPagador` string, nullable: Texto que será apresentado ao pagador para que ele preencha alguma informação destinada ao recebedor
    - `valor` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosValorCobranca, required
      - `valorOriginal` number, double, required: Valor da cobrança
      - `modalidadeAlteracao` 'NaoPermitida' | 'Permitida': 0 - NaoPermitida - Não permite alteração de valor 1 - Permitida - Permite alteração de valor
    - `calendario` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosCalendario, required
      - `expiracao` integer
    - `chave` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosChave, required: Tipo e valor da chave
      - `tipo` 'CPF' | 'CNPJ' | 'Telefone' | 'Email' | 'Aleatoria', required
      - `valor` string, required: >Caso seja do tipo PHONE, utilizar o código do país (iniciado por +), DDD e o número do telefone;<br></br> Caso seja do tipo CPF, somente 11 dígitos numéricos;<br></br> Caso seja CNPJ, somente 14 dígitos numéricos;<br></br> Caso seja email, deverá conter '@' e um '.'
    - `devedor` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosDevedorDinamicoImediato
      - `validaPagador` boolean
      - `pessoa` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosPessoa
        - `nome` string, required: Nome do beneficiário/recebedor retornado na consulta DICT
        - `nomeFantasia` string, nullable
        - `documento` string, required: Documento da pessoa: CPF, CNPJ.
        - `tipo` 'PessoaFisica' | 'PessoaJuridica', required
    - `informacoesAdicionais` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosInformacaoAdicional[], nullable
      - `nome` string, nullable: Nome do campo
      - `valor` string, nullable: Valor do campo
  - `retirada` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosRetirada
    - `ispb` string, required: ISPB do facilitador de serviço de saque (NR)
    - `valor` number, double
    - `modalidadeAlteracao` 'NaoPermitida' | 'Permitida', required: 0 - NaoPermitida - Não permite alteração de valor 1 - Permitida - Permite alteração de valor
    - `modalidadeAgente` 'FacilitadorDeServicoDeSaque' | 'EstabelecimentoComercial' | 'OutraEspeciePJouCorrespondenteNoPais', required
    - `finalidade` 'PixTroco' | 'PixSaque', required: 1 - PixTroco - Utilizado paga transações de pix - saque 2 - PixSaque - Utilizado paga transações de pix - troco

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/bs2/apis/api-v1-bs2-pix-indireto-cobranca-bfi.md) - [All operations](https://skmtc.dev/bs2/apis/api-v1-bs2-pix-indireto-cobranca-bfi/llms.txt) - [OpenAPI document](https://skmtc.dev/bs2/apis/api-v1-bs2-pix-indireto-cobranca-bfi/revisions/3cd6f55b1aef?raw)