---
title: "Criar autorização"
method: POST
path: "/v3/pix/automatic/authorizations"
---

# Criar autorização

`POST /v3/pix/automatic/authorizations`

## Request

- Base URL: `https://payment.safe2pay.com.br`
- URL: `https://payment.safe2pay.com.br/v3/pix/automatic/authorizations`
- Auth: API key in header `X-API-KEY`

## Request body

- object
  - `Application` string, required: Nome da aplicação ou sistema que está iniciando a requisição de autorização. Ex: "Plataforma ERP X", "App do Banco Y".
  - `Contract` object, required: Objeto com dados contratuais da autorização.
    - `Description` string, required: Descrição do propósito da autorização. Ex: “Pagamento de plano de saúde”, “Mensalidade escolar”
    - `Name` string, required: Nome que representa a autorização.
    - `Customer` object, required: Dados do devedor referente ao serviço contratado.
      - `Identity` string, required: CPF/CNPJ do pagador.
      - `Name` string, required: Nome do pagador.
      - `Email` string, required: E-mail do pagador.
      - `Phone` string, required: Telefone do pagador.
      - `Address` object, required: Endereço do pagador.
        - `ZipCode` string, required: CEP do endereço do pagador.
        - `Street` string, required: Rua do endereço do pagador.
        - `Number` string, required: Número do endereço do pagador.
        - `Complement` string: Complemento do endereço do pagador.
        - `District` string, required: Bairro do endereço do pagador.
        - `StateInitials` string, required: Estado do endereço do pagador.
        - `CityName` string, required: Cidade do endereço do pagador.
        - `CountryName` string, required: País do endereço do pagador.
  - `Calendar` object, required
    - `StartDate` string, date, required: Quando começa a vigência da autorização.
    - `EndDate` string, date: Se não for informado, a autorização não terá data de fim.
    - `Periodicity` string, required: Se refere a frequência. Ex: "SEMANAL", "MENSAL", "TRIMESTRAL", "SEMESTRAL" ou "ANUAL".
    - `RetryPolicy` string, required: Política de retentativa para os casos de falha por falta de saldo na conta do pagador. Ex: “NAO_PERMITE” ou “PERMITE_3R_7D”. [Clique aqui para saber mais](https://developers.safe2pay.com.br/docs/cobranca-pix-automatico-agendamento-retentativas#/)
  - `Amount` object
    - `Fixed` number, double: Valor fixo autorizado em cada cobrança. (Não usar junto com Minimum)
    - `Minimum` number, double: Valor mínimo que o pagador pode utilizar como referência para definir o valor máximo da cobrança. Ao aprovar uma autorização, o pagador pode estabelecer um valor máximo a ser debitado. Esse valor máximo não pode ser inferior ao valor mínimo definido. No entanto, o Merchant tem a flexibilidade de cobrar valores menores que esse mínimo estabelecido. (Não usar junto com Fixed)
  - `ImmediatePayment` object: Usado se há cobrança imediata no momento da autorização. Por padrão, o pagador terá 24h a partir da data de criação da autorização para realizar a autorização e pagamento.
    - `Amount` number, double, required: Valor do pagamento imediato no momento da aprovação da autorização.
    - `Splits` object[]: Divisão do valor entre recebedores ou contas diferentes. Ideal para marketplaces.
      - `CodeTaxType` integer, required: Indica o tipo de valor. Informar 1 para Percentual ou 2 para Valor. Ex: 1
      - `IdReceiver` integer, required: Código da empresa recebedora no Safe2Pay.
      - `Amount` number, double, required: Valor do split em percentual ou valor (baseado no CodeTaxType).
      - `IsPayTax` boolean: Indica se o recebedor participará do rateio no pagamento da taxa de custo da Safe2Pay.
    - `Reference` string, required: Referência única da autorização no sistema do recebedor. Útil para rastreamento e conciliação. Máximo de 60 caracteres.

## Response `201`

Created

## Other responses

- `422`: Unprocessable Entity

## Changes

- **2026-11-03** `fafb98858454`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/safe2pay/apis/payment/changes/v3/pix/automatic/authorizations/post.md)

---

[API](https://skmtc.dev/safe2pay/apis/payment.md) - [All operations](https://skmtc.dev/safe2pay/apis/payment/llms.txt) - [OpenAPI document](https://skmtc.dev/safe2pay/apis/payment/revisions/fafb98858454?raw)