openapi: 3.2.0
info:
  title: faturas Reschedule Automatic Pix Payment API
  version: '1.0'
servers:
- url: https://api.iugu.com/v1
security:
- sec0: []
tags:
- name: Reschedule Automatic Pix Payment
paths:
  /{id}/reschedule_automatic_pix_payment:
    post:
      description: 'Solicita um novo agendamento de cobrança para uma fatura cujo débito foi cancelado por insuficiência de saldo. Esta operação só é disponível quando a recorrência foi criada com retry_policy: retry_allowed.'
      responses:
        '200':
          description: ''
        '400':
          content:
            application/json:
              schema:
                type: object
                properties: {}
              examples:
                'Bad Request - Conta não é PJ ':
                  summary: 'Bad Request - Conta não é PJ '
                  value:
                    errors:
                      automatic_pix: Only legal entity accounts can use Automatic PIX
                Bad Request - Fatura não expirada:
                  summary: Bad Request - Fatura não expirada
                  value:
                    errors:
                      automatic_pix: Only expired invoices can reschedule an Automatic PIX payment
                Bad Request - Janela de retentativa expirada:
                  summary: Bad Request - Janela de retentativa expirada
                  value:
                    errors:
                      automatic_pix: Automatic PIX payment rescheduling is only allowed within 7 days of expiration (BACEN rule)
          description: Bad Request
      parameters:
      - in: path
        name: id
        schema:
          type: string
        required: true
        description: UUID da fatura (expired) associada ao agendamento que falhou por insuficiência de saldo.
      operationId: post_id-reschedule-automatic-pix-payment
      summary: Solicitar Retentativa de Agendamento
      tags:
      - Reschedule Automatic Pix Payment
components:
  securitySchemes:
    sec0:
      type: apiKey
      name: api_token
      in: query
x-readme-fauxas: true
x-provenance:
  method: searched
  source: https://dev.iugu.com/reference
  harvested: '2026-10-14'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://dev.iugu.com/reference/buscar-fatura-por-id-externos-de-subcontas.md
  - https://dev.iugu.com/reference/buscar-fatura-por-ids-externos.md
  - https://dev.iugu.com/reference/buscar-fatura.md
  - https://dev.iugu.com/reference/buscar-um-agendamento-de-pix-automatico.md
  - https://dev.iugu.com/reference/cancelar-agendamento-pix-automatico.md
  - https://dev.iugu.com/reference/cancelar-pix-automatico.md
  - https://dev.iugu.com/reference/cancelar.md
  - https://dev.iugu.com/reference/capturar-fatura.md
  - https://dev.iugu.com/reference/considerar-fatura-paga-externamente.md
  - https://dev.iugu.com/reference/consultar-cancelamento-de-pix-automatico.md
  - https://dev.iugu.com/reference/consultar-pix-automatico.md
  - https://dev.iugu.com/reference/criar-fatura.md
  - https://dev.iugu.com/reference/enviar-por-email.md
  - https://dev.iugu.com/reference/gerar-segunda-via.md
  - https://dev.iugu.com/reference/listar-cancelamentos-de-pix-automatico.md
  - https://dev.iugu.com/reference/listar-faturas.md
  - https://dev.iugu.com/reference/listar-pix-automatico.md
  - https://dev.iugu.com/reference/pix-automatico-jornada-2.md
  - https://dev.iugu.com/reference/reembolsar-fatura.md
  - https://dev.iugu.com/reference/solicitar-retentativa-de-agendamento.md
  - https://dev.iugu.com/reference/validate-signature.md
  merge:
    pages: 21
    deduped: 20
    conflicts_kept_first: 0