> ## Documentation Index
> Fetch the complete documentation index at: https://docs.goatpay.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar autorização PIX Automático

> Jornada 3: QR com 1ª parcela + consentimento recorrente (Conta Padrão verificada).

Guia completo: [PIX automático](/api-reference/guides/pix#pix-automatico).

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST 'https://api.goatpay.com.br/v1/pix-automatic/authorizations/create' \
    -H 'X-API-Key: gp_live_SUA_CHAVE' \
    -H 'Content-Type: application/json' \
    -d '{ "frequency": "MONTHLY", "contractId": "CONTRACT-123", "startDate": "2026-06-01", "customerId": "cus_cliente_psp", "value": 99.9, "description": "Assinatura mensal", "immediateQrCode": { "expirationSeconds": 3600, "originalValue": 10, "description": "Taxa de adesão" } }'
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "success": true,
    "message": "Autorização PIX Automático criada",
    "data": {
      "id": "a33047b1-fb19-4b68-9373-a7ba8a8162aa",
      "status": "CREATED",
      "frequency": "MONTHLY",
      "contractId": "CONTRACT-123",
      "value": 99.9,
      "startDate": "2026-06-01",
      "customerId": "clx_customer",
      "description": "Assinatura mensal",
      "dateCreated": "2026-05-31T10:00:00.000Z"
    },
    "requestId": "req_abc"
  }
  ```
</ResponseExample>

### Corpo da requisição

<ParamField body="frequency" type="string" required>
  WEEKLY, MONTHLY, QUARTERLY, SEMIANNUALLY, ANNUALLY.
</ParamField>

<ParamField body="contractId" type="string" required>
  Código do contrato (máx. 35 caracteres).
</ParamField>

<ParamField body="startDate" type="string" required>
  Início da vigência YYYY-MM-DD.
</ParamField>

<ParamField body="customerId" type="string" required>
  ID do cliente (`POST /customers/create`).
</ParamField>

<ParamField body="immediateQrCode" type="object" required>
  Primeira cobrança que ativa a autorização.
</ParamField>

<ParamField body="immediateQrCode.originalValue" type="number" required>
  Valor da 1ª parcela.
</ParamField>

<ParamField body="immediateQrCode.expirationSeconds" type="number" required>
  Validade do QR em segundos.
</ParamField>

<ParamField body="value" type="number">
  Valor fixo das recorrências (obrigatório com paymentCreationMode SUBSCRIPTION).
</ParamField>

<ParamField body="finishDate" type="string">
  Fim da vigência YYYY-MM-DD.
</ParamField>

<ParamField body="paymentCreationMode" type="string">
  MANUAL (padrão) ou SUBSCRIPTION.
</ParamField>

<Note>
  Produto deve estar habilitado na sua conta — solicite ao suporte GoatPay se receber erro de produto indisponível.
</Note>