---
updatedAt: 2026-09-01T18:45:41.000Z
agentTools:
  projectIndex: https://dev.iugu.com/llms.txt
---

# Pix Automático Recebedor - Jornada 2

Cria uma autorização de recorrência via Pix Automático (Jornada 2) sem gerar cobrança associada no momento da criação. Destinada a clientes que possuem motor de recorrência próprio e desejam migrar uma base já ativa (boleto, cartão ou Pix manual) para o débito automático, sem forçar uma cobrança fora do ciclo vigente.  O endpoint retorna apenas o QR Code de recorrência. As cobranças de cada ciclo devem ser agendadas posteriormente através de POST /v1/invoices.

<Callout icon="⚠️" theme="warn">
  ### Disponibilidade

  Endpoint exclusivo para contas **PJ**. Contas Pessoa Física não são suportadas.
</Callout>

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "faturas",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.iugu.com/v1"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "name": "api_token",
        "in": "query"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/automatic_pix/receiver_recurrences": {
      "post": {
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "examples": {
                  "Ok": {
                    "summary": "Ok",
                    "value": {
                      "id": "3f7c9d21-84be-4a05-b1e2-6d5417c0af38",
                      "receiver_rec_id": "RN0473820120260807HKMPQRXZANV",
                      "status": "created",
                      "qrcode_text": "00020126180014br.gov.bcb.pix5204000053039865802BR5925IUGU INSTITUICAO DE PAGAM6006CIDADE62070503***80920014br.gov.bcb.pix2570qr.iugu.com/public/payload/v2/rec/3f7c9d21-84be-4a05-b1e2-6d5417c0af386304ED12",
                      "qrcode": "iVBORw0KGgoAAAANSUhEUgAAANQAAADUAQAAAADMpTC1AAACQUlEQVR4nN2Yu60oNwxEj4yXjzrY/svaDkYVHAfaGxk3MwNb0UICluBnOEMu+e2cv359gv/O21prs9nrsPbZe3PYa609Yg+jCZBUbNuQaDrk+9q8yFtOyCYU1p6M9eYk59nvIvDSf+GfvxxD0qamkBbxXs7lj9Y2EVMTx/K3XJB/XB/IO+PfdzBGhGJUx/zLIS8P7yYvPPACGekvWFMtptY00YYh/7AIiaGmjSS0Y/VpaqlttbnZg075d/vZB4dUDMQ5/6oEU43atqZj/mlJaCQqGHDOv0ivRa1NWstUf8GSxPLlriLtlL0/0LD2S3NWFw8e2DjGD0lCP46VEqFjeDdpk1QasWoH8acFitgG2+ZCccYett6qLL0F01H8QWivavrYnczhrzF8tBfho8IpffbCpjRdbI4uN5s9hYfbYX74/etl0rH+EkCbFKIF78dU/hSxNjQGjYN47+W/RNCWRObwF9pc5BHtJ9fm+D1NrqRWIlfJjOEP+tVnG3KB2I7xUc6DZ0E5FPbjyiAfWRqS5mrBn/ocrJeQ29iuTSBT+nN5npeH7vfnKmfj6pSeT01LCkDzU7Fz/Ge9VkP6qaaM4a8Wro6pIdgraubmlWqQhko+FTMWz5jbxwrxZzsyqCe84asxiCVO8dEfFoRyeGCfri7CPsvB/ZKlQsRbrU7Nt8t9AvCyATzs9K595vZLnDegdPP03CXTSDz/XHOeA/vNZvdx45w+iyY1d6YVPyDO8S25q5A7GDVXpU3xw69P/4t98t9JbG4gOY+f1AAAAABJRU5ErkJggg=="
                    }
                  }
                }
              }
            }
          }
        },
        "parameters": [],
        "summary": "Pix Automático Recebedor - Jornada 2",
        "operationId": "post_automatic-pix-receiver-recurrences",
        "description": "Cria uma autorização de recorrência via Pix Automático (Jornada 2) sem gerar cobrança associada no momento da criação. Destinada a clientes que possuem motor de recorrência próprio e desejam migrar uma base já ativa (boleto, cartão ou Pix manual) para o débito automático, sem forçar uma cobrança fora do ciclo vigente.  O endpoint retorna apenas o QR Code de recorrência. As cobranças de cada ciclo devem ser agendadas posteriormente através de POST /v1/invoices.",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "payer": {
                    "type": "object",
                    "description": "Dados do pagador (devedor da recorrência)",
                    "properties": {
                      "name": {
                        "type": "string",
                        "description": "Nome do pagador"
                      },
                      "cpf_cnpj": {
                        "type": "string",
                        "description": "CPF ou CNPJ do pagador"
                      }
                    }
                  },
                  "frequency": {
                    "type": "string",
                    "description": "Frequência das cobranças. Valores: `weekly`, `monthly`, `quarterly`, `semiannual`, `annual`"
                  },
                  "recurrence_beginning": {
                    "type": "string",
                    "format": "date",
                    "description": "Data de início da recorrência (futura, formato AAAA-MM-DD)"
                  },
                  "contract_number": {
                    "type": "string",
                    "description": "Identificador do contrato/pedido. Máx. 35 caracteres"
                  },
                  "end_date": {
                    "type": "string",
                    "format": "date",
                    "description": "Data de encerramento da recorrência (se informada, deve ser posterior a `recurrence_beginning`)"
                  },
                  "retry_policy": {
                    "type": "string",
                    "description": "Política de retentativa. `retry_not_allowed` (padrão) ou `retry_allowed`"
                  }
                },
                "required": [
                  "contract_number",
                  "recurrence_beginning",
                  "frequency"
                ]
              },
              "examples": {}
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```