---
title: "Atualizar autorização"
method: PATCH
path: "/pix/automatic/authorizations/{id}"
tags: ["Pix Automático"]
---

# Atualizar autorização

`PATCH /pix/automatic/authorizations/{id}`

Permite atualizar o split_payment de uma autorização. O valor informado substitui completamente as informações existentes.

## Parameters

- `#/paths/~1payins/post/parameters/0` — unresolved $ref

## Request body

- object
  - `split_payment` PaymentSplit[], nullable — Array de destinatários para pagamento automático. Envie array vazio ou null para remover o split de pagamento existente.
    - `mode` 'FIXADO' | 'PERCENTUAL'
    - `amount` number
    - `destination_bank_account` object
      - `pix_key_type` 'CHAVE_ALEATORIA' | 'EMAIL' | 'TELEFONE' | 'CPF' | 'CNPJ'
      - `pix_key` string
    - `payment_date` string, date — Data para agendamento da execução do split
    - `split_days_after_settled` integer — Número de dias após a liquidação para agendamento da execução do split

## Response `200`

OK

- 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

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

[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/revisions/cf24b926bbaa/schema)