---
title: "Requisitar nova autorização"
method: POST
path: "/pix/automatic/authorizations"
tags: ["Pix Automático"]
---

# Requisitar nova autorização

`POST /pix/automatic/authorizations`

## Request body

- union
  - AuthorizationRequest — Solicitação de autorização enviada diretamente ao PSP do pagador.
    - `type` 'authorization', required
    - `frequency` 'weekly' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual', required
    - `retry_policy` 'not_allowed' | 'allow_three_in_seven_days', required
    - `start_date` string, date, required — Data de início da autorização (YYYY-MM-DD)
    - `end_date` string, date — Data fim da autorização (YYYY-MM-DD)
    - `expiration_date` string, date-time — Data limite para aceite da autorização pelo pagador (YYYY-MM-DD hh:mm:ss). Prazo máximo de 30 dias. Caso não seja configurada, o valor padrão é até 20:59:59 do dia da data de início.
    - `fixed_amount` integer — - valor em centavos - obrigatório para autorizações com valor fixo
    - `max_amount_floor` integer — - valor em centavos - obrigatório para autorizações com valor variável
    - `identifier` string, required — Identificador da autorização. Pode ser um número de contrato por exemplo.
    - `description` string — Descrição da autorização. Será exibida ao cliente pagador
    - `payer` object, required
      - `name` string, required
      - `tax_id` string, required
      - `bank_ispb` string, required
      - `branch` string, required
      - `account` string, required — Número da conta com dígito
    - `debtor` object — Informar caso o devedor seja diferente do pagador
      - `name` string, required
      - `tax_id` string, required
    - `split_payment` AuthorizationSplitPayment[] — Configuração de divisão de pagamento entre múltiplos recebedores
      - `mode` 'fixed' | 'percentage', required — Tipo de divisão de pagamento
      - `amount` integer — Valor em centavos para divisão de pagamento no modo "fixed"
      - `amount_percent` number, float — Percentual para divisão de pagamento no modo "percentage"
      - `receiver` object, required — Dados do recebedor do valor dividido
        - `pix_key` string, required
      - `split_days_after_settled` integer — Número de dias após a liquidação do pagamento para repassar o valor ao recebedor
    - `auto_create_payment_intent` boolean — Define se a recorrência da autorização será gerenciada automaticamente pelo sistema. Quando definido como true, as instruções de pagamento (payment intents) serão criadas automaticamente de acordo com a frequência estabelecida. Este campo só pode ser definido como true para autorizações com valor fixo (fixed_amount informado). O retry automático é realizado apenas para intenções com status 'accepted' que possuem data de liquidação atrasada. Para os demais status (rejected, canceled, failed), a notificação é enviada via webhook para que o cliente decida como proceder.
  - AuthorizationQRCodeRequest — Solicitação de autorização através de um QRCode contendo apenas os dados da autorização.
    - `type` 'authorization_qrcode', required
    - `frequency` 'weekly' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual', required
    - `retry_policy` 'not_allowed' | 'allow_three_in_seven_days', required
    - `start_date` string, date, required — Data de início da autorização (YYYY-MM-DD). Também configura data limite para aceite da autorização pelo pagador.
    - `end_date` string, date — Data fim da autorização (YYYY-MM-DD)
    - `fixed_amount` integer — - valor em centavos - obrigatório para autorizações com valor fixo
    - `max_amount_floor` integer — - valor em centavos - obrigatório para autorizações com valor variável
    - `identifier` string, required — Identificador da autorização. Pode ser um número de contrato por exemplo.
    - `description` string — Descrição da autorização. Será exibida ao cliente pagador
    - `debtor` object, required
      - `name` string, required
      - `tax_id` string, required
    - `split_payment` AuthorizationSplitPayment[] — Configuração de divisão de pagamento entre múltiplos recebedores
      - `mode` 'fixed' | 'percentage', required — Tipo de divisão de pagamento
      - `amount` integer — Valor em centavos para divisão de pagamento no modo "fixed"
      - `amount_percent` number, float — Percentual para divisão de pagamento no modo "percentage"
      - `receiver` object, required — Dados do recebedor do valor dividido
        - `pix_key` string, required
      - `split_days_after_settled` integer — Número de dias após a liquidação do pagamento para repassar o valor ao recebedor
    - `auto_create_payment_intent` boolean — Define se a recorrência da autorização será gerenciada automaticamente pelo sistema. Quando definido como true, as instruções de pagamento (payment intents) serão criadas automaticamente de acordo com a frequência estabelecida. Este campo só pode ser definido como true para autorizações com valor fixo (fixed_amount informado). O retry automático é realizado apenas para intenções com status 'accepted' que possuem data de liquidação atrasada. Para os demais status (rejected, canceled, failed), a notificação é enviada via webhook para que o cliente decida como proceder.
  - AuthorizationWithImmediatePaymentRequest — Solicitação de autorização através de um QRCode para pagamento imediato.
    - `type` 'immediate_payment_authorization', required
    - `frequency` 'weekly' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual', required
    - `retry_policy` 'not_allowed' | 'allow_three_in_seven_days', required
    - `start_date` string, date, required — Data de início da autorização (YYYY-MM-DD)
    - `end_date` string, date — Data fim da autorização (YYYY-MM-DD)
    - `fixed_amount` integer — - valor em centavos - obrigatório para autorizações com valor fixo
    - `max_amount_floor` integer — - valor em centavos - obrigatório para autorizações com valor variável
    - `identifier` string, required — Identificador da autorização. Pode ser um número de contrato por exemplo.
    - `description` string — Descrição da autorização. Será exibida ao cliente pagador
    - `debtor` object, required
      - `name` string, required
      - `tax_id` string, required
      - `email` string
      - `postal_code` string
      - `city` string
      - `state` string
      - `address` string
    - `split_payment` AuthorizationSplitPayment[] — Configuração de divisão de pagamento entre múltiplos recebedores
      - `mode` 'fixed' | 'percentage', required — Tipo de divisão de pagamento
      - `amount` integer — Valor em centavos para divisão de pagamento no modo "fixed"
      - `amount_percent` number, float — Percentual para divisão de pagamento no modo "percentage"
      - `receiver` object, required — Dados do recebedor do valor dividido
        - `pix_key` string, required
      - `split_days_after_settled` integer — Número de dias após a liquidação do pagamento para repassar o valor ao recebedor
    - `auto_create_payment_intent` boolean — Define se os agendamentos recorrentes da autorização serão gerenciados automaticamente pelo sistema. Quando definido como true, as instruções de pagamento serão criadas automaticamente de acordo com a frequência estabelecida, e a data da primeira instrução do ciclo será a data de início da autorização (start_date). Este campo só pode ser definido como true para autorizações com valor fixo (fixed_amount informado). O retry automático é realizado apenas para intenções com status 'accepted' que possuem data de liquidação atrasada. Para os demais status (rejected, canceled, failed), a notificação é enviada via webhook para que o cliente decida como proceder.
    - `payment` AuthorizationImmediatePayment, required
      - `txid` string — Um txid aleatório será gerado caso não seja informado
      - `integration_id` string
      - `pix_key` string, required
      - `amount` integer, required
      - `expiration` integer — Expiração da cobrança em segundos
      - `modality` 'fixed_amount' | 'modifiable_amount', required
      - `description` string
      - `additional_info` object[]
        - `key` string
        - `value` string
  - AuthorizationWithDueDatePaymentRequest — Solicitação de autorização através de um QRCode para pagamento com vencimento. A aprovação da autorização será opcional para o pagador e poderá ser feita após o pagamento.
    - `type` 'opt_in_authorization', required
    - `frequency` 'weekly' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual', required
    - `retry_policy` 'not_allowed' | 'allow_three_in_seven_days', required
    - `start_date` string, date, required — Data de início da autorização (YYYY-MM-DD)
    - `end_date` string, date — Data fim da autorização (YYYY-MM-DD)
    - `fixed_amount` integer — - valor em centavos - obrigatório para autorizações com valor fixo
    - `max_amount_floor` integer — - valor em centavos - obrigatório para autorizações com valor variável
    - `identifier` string, required — Identificador da autorização. Pode ser um número de contrato por exemplo.
    - `description` string — Descrição da autorização. Será exibida ao cliente pagador
    - `debtor` object, required
      - `name` string, required
      - `tax_id` string, required
      - `email` string
      - `postal_code` string
      - `city` string
      - `state` string
      - `address` string
    - `split_payment` AuthorizationSplitPayment[] — Configuração de divisão de pagamento entre múltiplos recebedores
      - `mode` 'fixed' | 'percentage', required — Tipo de divisão de pagamento
      - `amount` integer — Valor em centavos para divisão de pagamento no modo "fixed"
      - `amount_percent` number, float — Percentual para divisão de pagamento no modo "percentage"
      - `receiver` object, required — Dados do recebedor do valor dividido
        - `pix_key` string, required
      - `split_days_after_settled` integer — Número de dias após a liquidação do pagamento para repassar o valor ao recebedor
    - `auto_create_payment_intent` boolean — Define se os agendamentos recorrentes da autorização serão gerenciados automaticamente pelo sistema. Quando definido como true, as instruções de pagamento serão criadas automaticamente de acordo com a frequência estabelecida, e a data da primeira instrução do ciclo será a data de início da autorização (start_date). Este campo só pode ser definido como true para autorizações com valor fixo (fixed_amount informado). O retry automático é realizado apenas para intenções com status 'accepted' que possuem data de liquidação atrasada. Para os demais status (rejected, canceled, failed), a notificação é enviada via webhook para que o cliente decida como proceder.
    - `payment` AuthorizationDueDatePayment, required
      - `txid` string — Um txid aleatório será gerado caso não seja informado
      - `integration_id` string
      - `pix_key` string, required
      - `due_date` string, required
      - `expiration` integer, nullable — Número de dias após a data de vencimento em que a cobrança irá expirar
      - `amount` integer, required — Valor em centavos
      - `description` string
      - `fine_type` 'fixed' | 'percentage'
      - `fine_amount` integer
      - `fine_percent` number
      - `interest_type` 'fixed_per_day' | 'fixed_per_working_day' | 'percentage_per_day' | 'percentage_per_month' | 'percentage_per_year' | 'percentage_per_working_day' | 'percentage_per_month_working_days' | 'percentage_per_year_working_days'
      - `interest_amount` integer
      - `interest_percent` number
      - `discount_type` 'fixed_until_informed_dates' | 'percentage_until_informed_dates' | 'fixed_per_anticipated_day' | 'fixed_per_anticipated_working_day' | 'percentage_per_anticipated_day' | 'percentage_per_anticipated_working_day'
      - `discount_amount` integer
      - `discount_percent` number
      - `discount_dates` object[]
        - `amount` integer
        - `percent` number
        - `date` string, date
      - `abatement_type` 'fixed' | 'percentage'
      - `abatement_amount` integer
      - `abatement_percent` number
      - `additional_info` object[]
        - `key` string
        - `value` string
  - AuthorizationWithStaticPaymentRequest — Solicitação de autorização através de um QRCode estático para pagamento. A aprovação da autorização será opcional para o pagador e poderá ser feita após o pagamento.
    - `type` 'static_opt_in_authorization', required
    - `frequency` 'weekly' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual', required
    - `retry_policy` 'not_allowed' | 'allow_three_in_seven_days', required
    - `start_date` string, date, required — Data de início da autorização (YYYY-MM-DD). Também configura data limite para aceite da autorização pelo pagador.
    - `end_date` string, date — Data fim da autorização (YYYY-MM-DD)
    - `fixed_amount` integer — - valor em centavos - obrigatório para autorizações com valor fixo
    - `max_amount_floor` integer — - valor em centavos - obrigatório para autorizações com valor variável
    - `identifier` string, required — Identificador da autorização. Pode ser um número de contrato por exemplo.
    - `description` string — Descrição da autorização. Será exibida ao cliente pagador
    - `debtor` object, required
      - `name` string, required
      - `tax_id` string, required
      - `email` string
      - `postal_code` string
      - `city` string
      - `state` string
      - `address` string
    - `split_payment` AuthorizationSplitPayment[] — Configuração de divisão de pagamento entre múltiplos recebedores
      - `mode` 'fixed' | 'percentage', required — Tipo de divisão de pagamento
      - `amount` integer — Valor em centavos para divisão de pagamento no modo "fixed"
      - `amount_percent` number, float — Percentual para divisão de pagamento no modo "percentage"
      - `receiver` object, required — Dados do recebedor do valor dividido
        - `pix_key` string, required
      - `split_days_after_settled` integer — Número de dias após a liquidação do pagamento para repassar o valor ao recebedor
    - `auto_create_payment_intent` boolean — Define se os agendamentos recorrentes da autorização serão gerenciados automaticamente pelo sistema. Quando definido como true, as instruções de pagamento serão criadas automaticamente de acordo com a frequência estabelecida, e a data da primeira instrução do ciclo será a data de início da autorização (start_date). Este campo só pode ser definido como true para autorizações com valor fixo (fixed_amount informado). O retry automático é realizado apenas para intenções com status 'accepted' que possuem data de liquidação atrasada. Para os demais status (rejected, canceled, failed), a notificação é enviada via webhook para que o cliente decida como proceder.
    - `payment` AuthorizationStaticPayment, required
      - `txid` string — Um txid aleatório será gerado caso não seja informado
      - `integration_id` string
      - `pix_key` string, required
      - `amount` integer
      - `description` string

## Response `200`

- AuthorizationResponse
  - `id` string, uuid
  - `type` 'authorization' | 'authorization_qrcode' | 'immediate_payment_authorization' | 'opt_in_authorization' | 'static_opt_in_authorization'
  - `status` 'pending' | 'accepted' | 'rejected' | 'canceled' | 'failed'
  - `end_to_end_id` string
  - `frequency` 'weekly' | 'monthly' | 'quarterly' | 'semi_annual' | 'annual'
  - `retry_policy` 'not_allowed' | 'allow_three_in_seven_days'
  - `start_date` string, date
  - `expiration_date` string, nullable
  - `fixed_amount` integer
  - `max_amount_floor` integer
  - `identifier` string
  - `description` string
  - `payer` object
    - `name` string
    - `tax_id` string
    - `bank_ispb` string
    - `branch` string
    - `account` string
  - `debtor` object
    - `name` string
    - `tax_id` string
  - `payment_qrcode_txid` string, nullable
  - `qrcode_payload` string, nullable
  - `qrcode_image_base64` string, nullable
  - `error_code` string, nullable
  - `reject_reason` string, nullable — Preenchido caso a autorização seja rejeitada pelo PSP do pagador ou usuário pagador
  - `authorized_at` string, date-time, nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `split_payment` AuthorizationSplitPayment[] — Configuração de divisão de pagamento entre múltiplos recebedores
    - `mode` 'fixed' | 'percentage', required — Tipo de divisão de pagamento
    - `amount` integer — Valor em centavos para divisão de pagamento no modo "fixed"
    - `amount_percent` number, float — Percentual para divisão de pagamento no modo "percentage"
    - `receiver` object, required — Dados do recebedor do valor dividido
      - `pix_key` string, required
    - `split_days_after_settled` integer — Número de dias após a liquidação do pagamento para repassar o valor ao recebedor

---

[API](https://skmtc.net/transfeera/apis/autentica-o.md) · [All operations](https://skmtc.net/transfeera/apis/autentica-o/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/transfeera/autentica-o/versions/cf24b926bbaa/schema)