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

# Criar Qr Code Dinâmico com Vencimento

`POST /pix/indireto/qrcode/dinamico-vencimento`

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>Vence, significando que pode ser pago após o vencimento e as parametriações de juros e multas serão aplicadas;</li><li>Expira, significando que não poderá ser mais pago;</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

- Bs2Core2PixIndiretoQRCodeCobrancaAppApisForIntegrationQrCodeCriarQrCodeDinamicoVencimentoCriarQrCodeDinamicoVencimento
  - `cobranca` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosCobrancaVencimento, 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
    - `calendario` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosCalendarioVencimento, required
      - `vencimento` string, date-time — Data de vencimento do pagamento, no formato yyyy-mm-dd
      - `validadeDiasAposVencimento` integer, nullable — Dias Apos o vencimento que o pagamento ainda sera aceito
    - `devedor` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosDevedorDinamicoVencimento, required
      - `validaPagador` boolean — Se valida ou não os dados do pagador
      - `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
      - `endereco` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosEndereco
        - `logradouro` string, required
        - `numero` string, required
        - `complemento` string, nullable
        - `bairro` string, nullable
        - `cidade` string, required
        - `codigoPostal` string, nullable
        - `uf` string, required
        - `pais` string, nullable
    - `valor` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosValorCobrancaVencimento, required
      - `valorOriginal` number, double, required — É o valor original da cobrança, antes dos juros, multas e afins
      - `modalidadeAlteracao` 'NaoPermitida' | 'Permitida' — 0 - NaoPermitida - Não permite alteração de valor 1 - Permitida - Permite alteração de valor
      - `multa` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosMulta
        - `valorModalidade` number, double
        - `modalidade` 'ValorFixo' | 'Percentual' — ## Modalidade da multa, conforme tabela de domínios. | Modalidade | Domínio | | -----------|---------| | Valor Fixo | 0 | | Percentual | 1 |
      - `juros` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosJuros
        - `valorModalidade` number, double
        - `modalidade` 'ValorDiasCorridos' | 'PercentualAoDiaDiasCorridos' | 'PercentualAoMesDiasCorridos' | 'PercentualAoAnoDiasCorridos' | 'ValorDiasUteis' | 'PercentualAoDiaDiasUteis' | 'PercentualAoMesDiasUteis' | 'PercentualAoAnoDiasUteis' — ## Modalidade de juros, conforme tabela de domínios. | Descrição | Domínio | | -----------|---------| | Valor ( dias corridos ) | 1 | | Percentual ao dia ( dias corridos ) | 2 | | Percentual ao mês ( dias corridos ) | 3 | | Percentual ao ano ( dias corridos | 4 | | Valor ( dia úteis ) | 5 | | Percentual ao dia ( dia úteis ) | 6 | | Percentual ao mês ( dias úteis ) | 7 | | Percentual ao ano ( dias úteis ) | 8 |
      - `abatimento` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosAbatimento
        - `valorModalidade` number, double
        - `modalidade` 'ValorFixo' | 'Percentual' — ## Modalidade da abatimento, conforme tabela de domínios. | Modalidade | Domínio | | -----------|---------| | Valor Fixo | 0 | | Percentual | 1 |
      - `desconto` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosDesconto
        - `valorModalidade` number, double
        - `modalidade` 'ValorFixoAteData' | 'PercentualAteData' | 'ValorPorAntecipacaoDiaCorrido' | 'ValorPorAntecipacaoDiaUtil' | 'PercentualPorAntecipacaoDiaCorrido' | 'PercentualPorAntecipacaoDiaUtil' — ## Modalidade de descontos, conforme tabela de domínios. | Descrição | Domínio | | ----------|---------| | Valor Fixo até a[s] data[s] informada[s] | 0 | | Percentual até a data informada | 1 | | Valor por antecipação dia corrido | 2 | | Valor por antecipação dia útil | 3 | | Percentual por antecipação dia corrido | 4 | | Percentual por antecipação dia útil | 5 |
        - `descontosDataFixa` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosDescontoDataFixa[], nullable
          - `data` string, date-time
          - `valor` number, double
    - `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 '.'
    - `informacoesAdicionais` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosInformacaoAdicional[], nullable
      - `nome` string, nullable — Nome do campo
      - `valor` string, nullable — Valor do campo
  - `recebedor` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosRecebedor, required
    - `codigoCategoria` string, nullable — Código da categoria do comerciante MCC ISO18245
    - `moeda` string, nullable — Código da moeda “986” – BRL: real brasileiro - ISO4217
    - `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
    - `endereco` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosEndereco, required
      - `logradouro` string, required
      - `numero` string, required
      - `complemento` string, nullable
      - `bairro` string, nullable
      - `cidade` string, required
      - `codigoPostal` string, nullable
      - `uf` string, required
      - `pais` string, nullable

## Response `201`

Created

- Bs2Core2PixIndiretoQRCodeCobrancaAppApisForIntegrationQrCodeCriarQrCodeDinamicoVencimentoQrCodeDinamicoVencimentoCriado
  - `id` string, uuid
  - `transactionId` string, nullable
  - `status` 'Ativo' | 'Expirado' | 'Pago' | 'RemovidoPsp' | 'Vencido'
  - `revisao` integer
  - `dataCriacao` string, date-time
  - `qrCode` string, nullable
  - `solicitacaoPagador` string, nullable
  - `chave` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosChave — 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` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosDevedorDinamicoVencimento
    - `validaPagador` boolean — Se valida ou não os dados do pagador
    - `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
    - `endereco` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosEndereco
      - `logradouro` string, required
      - `numero` string, required
      - `complemento` string, nullable
      - `bairro` string, nullable
      - `cidade` string, required
      - `codigoPostal` string, nullable
      - `uf` string, required
      - `pais` string, nullable
  - `calendario` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosCalendarioVencimento
    - `vencimento` string, date-time — Data de vencimento do pagamento, no formato yyyy-mm-dd
    - `validadeDiasAposVencimento` integer, nullable — Dias Apos o vencimento que o pagamento ainda sera aceito
  - `informacoesAdicionais` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosInformacaoAdicional[], nullable
    - `nome` string, nullable — Nome do campo
    - `valor` string, nullable — Valor do campo
  - `valor` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosValorCobrancaVencimento
    - `valorOriginal` number, double, required — É o valor original da cobrança, antes dos juros, multas e afins
    - `modalidadeAlteracao` 'NaoPermitida' | 'Permitida' — 0 - NaoPermitida - Não permite alteração de valor 1 - Permitida - Permite alteração de valor
    - `multa` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosMulta
      - `valorModalidade` number, double
      - `modalidade` 'ValorFixo' | 'Percentual' — ## Modalidade da multa, conforme tabela de domínios. | Modalidade | Domínio | | -----------|---------| | Valor Fixo | 0 | | Percentual | 1 |
    - `juros` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosJuros
      - `valorModalidade` number, double
      - `modalidade` 'ValorDiasCorridos' | 'PercentualAoDiaDiasCorridos' | 'PercentualAoMesDiasCorridos' | 'PercentualAoAnoDiasCorridos' | 'ValorDiasUteis' | 'PercentualAoDiaDiasUteis' | 'PercentualAoMesDiasUteis' | 'PercentualAoAnoDiasUteis' — ## Modalidade de juros, conforme tabela de domínios. | Descrição | Domínio | | -----------|---------| | Valor ( dias corridos ) | 1 | | Percentual ao dia ( dias corridos ) | 2 | | Percentual ao mês ( dias corridos ) | 3 | | Percentual ao ano ( dias corridos | 4 | | Valor ( dia úteis ) | 5 | | Percentual ao dia ( dia úteis ) | 6 | | Percentual ao mês ( dias úteis ) | 7 | | Percentual ao ano ( dias úteis ) | 8 |
    - `abatimento` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosAbatimento
      - `valorModalidade` number, double
      - `modalidade` 'ValorFixo' | 'Percentual' — ## Modalidade da abatimento, conforme tabela de domínios. | Modalidade | Domínio | | -----------|---------| | Valor Fixo | 0 | | Percentual | 1 |
    - `desconto` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosDesconto
      - `valorModalidade` number, double
      - `modalidade` 'ValorFixoAteData' | 'PercentualAteData' | 'ValorPorAntecipacaoDiaCorrido' | 'ValorPorAntecipacaoDiaUtil' | 'PercentualPorAntecipacaoDiaCorrido' | 'PercentualPorAntecipacaoDiaUtil' — ## Modalidade de descontos, conforme tabela de domínios. | Descrição | Domínio | | ----------|---------| | Valor Fixo até a[s] data[s] informada[s] | 0 | | Percentual até a data informada | 1 | | Valor por antecipação dia corrido | 2 | | Valor por antecipação dia útil | 3 | | Percentual por antecipação dia corrido | 4 | | Percentual por antecipação dia útil | 5 |
      - `descontosDataFixa` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosDescontoDataFixa[], nullable
        - `data` string, date-time
        - `valor` number, double
  - `location` Bs2Core2PixIndiretoQRCodeCobrancaAppApisCompartilhadosLocation
    - `id` string, uuid
    - `location` string, nullable
    - `tipo` 'COB' | 'COBV'
    - `dataCriacao` string, date-time

## 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)