---
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`

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.net/bs2/apis/bs2-core2-contacorrente-extrato-app-hosts-http-forintegratio.md) · [All operations](https://skmtc.net/bs2/apis/bs2-core2-contacorrente-extrato-app-hosts-http-forintegratio/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bs2/bs2-core2-contacorrente-extrato-app-hosts-http-forintegratio/revisions/989ddf3f68cd/schema)