---
title: "Create recurrent static QR Code"
method: POST
path: "/v1/pix/qrcode/static/recurrence"
tags: ["Recurring payment"]
---

# Create recurrent static QR Code

`POST /v1/pix/qrcode/static/recurrence`

Create a recurrent static QR Code and EMV (Europay Mastercard Visa) string. 

For more information, refer to [Pix and QR Codes](https://developers.pismo.io/pismo-docs/docs/pix-and-qr-codes).

**Note:** This endpoint takes an account token - an access token encoded with a Pismo account ID.

## Headers

- `Authorization` string, required

## Request body

- QrcodeCreateRecurrenceQrCodeStaticRequest
  - `payee` QrcodePayeeRequest, required — Payee information
    - `address` string, required — Location
    - `city` string, required — City where payment occurred.
    - `key` string, required — Payee Pix key (should have Pismo account)
    - `state` string, required — Brazilian state where payment will occur - two letter ISO 3166 code.
    - `zip_code` string, required — Location postal code.
    - `category` string — Receiver ISO 18245 merchant category code.
  - `amount` number, required — Initial payment amount
  - `transaction_identification` string, required — Client-generated unique transaction ID for client monitoring and tracking.
  - `additional_information` string — Additional information about the new QR Code creation
  - `location` QrcodeLocationStatic — Location URL information
    - `url_jwk` string — PSP Receiver's URL that holds key pairs in JSON format. Should be hosted on the same site associated with the CERTQRC certificate. Use the format "JWK Set URL" without the protocol (http/https). The Central Bank uses this field and `url_payload` to register and validate the QR Code. This field **must** be passed if the PSP requires it. The URL format is described in <a href="https://www.bcb.gov.br/content/estabilidadefinanceira/cedsfn/Manual_de_Seguranca_PIX.pdf" target="_blank">Manual de Segurança do PIX</a>.
    - `url_payload_rec` string — PSP Receiver's URL containing the recurence QR Code's JSON Web Signature (JWS). Should not include the protocol (http/https). The Central Bank uses this field and `url_jwk` to register and validate the QR Code. This field **must** be passed if the PSP requires it. The URL format is described in <a href="https://www.bcb.gov.br/content/estabilidadefinanceira/pix/Regulamento_Pix/II_ManualdePadroesparaIniciacaodoPix.pdf" target="_blank">Manual de Padrões para Iniciação do PIX</a>.
  - `recurrence_id` string — Recurrence ID. Either this or the `recurrence` object is **REQUIRED**.
  - `recurrence` QrcodeRecurrence — Recurrence object. Either this or `recurrence_id` is **REQUIRED**.
    - `frequency_type` 'WEEK' | 'MONTH' | 'QUARTER' | 'SEMESTER' | 'YEAR', required — Recurrence payment type
    - `first_payment_date` string, datetime, required — First charge/payment date. Format = yyyy-mm-dd
    - `last_payment_date` string, datetime — Last charge/payment date. Format = yyyy-mm-dd
    - `amount` number — Transaction amount.
    - `min_payment_amount` number — Payee-defined minimum payment amount for dynamic amount recurrences.
    - `debtor` Debtor, required
      - `document_number` string, required — Government ID, such as a CPF (Cadastro de Pessoas Fisicas - individual tax ID in Brazil) or a CNPJ (Cadastro Nacional de Pessoa Juridica - business tax ID in Brazil) number.
      - `document_type` 'LEGAL_PERSON' | 'NATURAL_PERSON', required — Person legal type: * `LEGAL_PERSON` - Person * `NATURAL_PERSON` - Company or organization
      - `name` string, required — Name
    - `contract_id` string, required — Payee-created external ID for their reference.
    - `description` string — Recurrence payment description
    - `allow_attempts_after_expiration` boolean — Allow transaction retries on failure? Default is `false`.
    - `taxes` Taxes — Only available in EXT environment for direct parciapants. Tax information related to the transaction.
      - `tax_identifier` string — Tax identifier, referring to the NF-e, NFS-e or aggregating tax document. In Brazil, NF-e and NFS-e are the two primary types of mandatory electronic invoices (Notas Fiscais) used for tax compliance. * NF-e (Nota Fiscal Eletrônica): Used for the sale and movement of physical goods or products. It is regulated at the state level by SEFAZ (SEFAZ (Secretaria da Fazenda) is the State Department of Finance in Brazil.) and travels with the goods. * NFS-e (Nota Fiscal de Serviços Eletrônica): Used for the provision of services (e.g., consulting, repairs, digital subscriptions). It is regulated by individual city governments. The value entered must correspond to the tax document used for calculating the IBS and CBS taxes associated with the transaction.
      - `records` Records[] — Tax record types information. You must pass, at a minimum, 2 objects - at least one with `CBS tax type and at least one with `IBS` tax type.
        - `tax_type` 'CBS' | 'IBS' — Tax type: * `IBS` = Goods and services tax. A state and municipal tax that unifies and replaces the main subnational consumption taxes (state ICMS and municipal ISS). * `CBS` = Contribution on goods and services. A federal tax that consolidates and replaces previous federal social contributions and taxes (PIS, Cofins, and IPI)
        - `amount` number — Tax amount. Must be greater than zero.
  - `access_token` string — Access token related to the `url_payload`/`url_payload_rec` fields, used to register and validate a QR code. This field **must** be provided if the PSP requires it. The URL format is described in the Manual of Standards for PIX Initiation.

## Response `202`

Generate COB QR Code response

- QrcodeCreateRecurrenceQrCodeStaticResponse — Create a Recurrence Static Qrcode response
  - `id` string, required — Pismo QR Code identifier
  - `access_token` string, required — QR Code access token generated and returned at creation.
  - `external_id` string, required — Client-generated record identifier for client tracking and monitoring.
  - `emv` string, required — Base 64 encoded discount QR Code payload. EMV = Europay, Mastercard and Visa, a global standard for credit and debit payment. The EMV might include details required for secure transactions such as cardholder informatipn, transaction amount, merchant information, and other relevant data.
  - `qrcode_imageb64` string — Base64 encoded QR Code
  - `recurrence_id` string, required — Recurrence ID. Either this or the `recurrence` object is **REQUIRED**.
  - `jws` string — JWS (JSON Web Signature) payload. When a JWT (JSON Web Token) is signed, it becomes a JWS.
  - `jws_rec` string — Signed JWS payload, referring to the data of the recurrence.

## Other responses

- `400` — Bad request
- `401` — Access token is missing or invalid
- `403` — The request has been lost
- `404` — Not Found
- `409` — The specified resource status conflicts with the current request.
- `429` — Too many reqquests
- `500` — Internal server error
- `502` — Bad Gateway
- `504` — Gateway Timeout

---

[API](https://skmtc.net/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.net/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pismo/platform-authentication/revisions/935b62e16de4/schema)