> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Solicitar una autorización de Pix Automático > Solicita una autorización de pago recurrente (recorrencia) como PSP Recebedor. Persiste la autorización en el estado Requested y devuelve el id de solicitud del upstream. ## OpenAPI ````yaml es/openapi/v3-current/pix.yaml POST /v1/pix-automatico/authorizations openapi: 3.0.3 info: title: Plugin BR Pix Directo - API completa description: > API completa para el sistema de pagos instantáneos Pix de Brasil, que incluye operaciones del diccionario de claves Pix, generación/decodificación de códigos QR, transacciones y límites transaccionales. version: 1.0.0 servers: - url: https://plugin-pix-direct.api.lerian.net - url: https://plugin-pix-direct-qrcode.api.lerian.net security: - bearerAuth: [] paths: /v1/pix-automatico/authorizations: post: tags: - Pix Automático API summary: Solicitar una autorización de Pix Automático description: >- Solicita una autorización de pago recurrente (recorrencia) como PSP Recebedor. Persiste la autorización en el estado Requested y devuelve el id de solicitud del upstream. requestBody: content: application/json: schema: $ref: '#/components/schemas/RequestAuthorizationBody' required: true responses: '202': content: application/json: schema: $ref: '#/components/schemas/RequestAuthorizationResponse' description: Aceptado default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Error components: schemas: RequestAuthorizationBody: additionalProperties: false properties: amount: description: >- Monto fijo del pago en reales (valor; omite/0 para una recurrencia variable). format: double type: number contractDesc: description: Descripción de contrato de texto libre (descContrato). type: string contractNumber: description: Identificador de contrato/orden (nrContrato). type: string createdDateTime: description: >- Marca de tiempo de creación de la recurrencia (dtHrCriacaoRecorrencia, UTC). type: string debtor: $ref: '#/components/schemas/AuthorizationDebtorBody' endDate: description: Fecha del último pago (dtFinalRecorrencia; aaaa-mm-dd). type: string expirationDateTime: description: >- Marca de tiempo de expiración de la solicitud (dtHrExpiracaoSolicitacao, UTC). type: string floorMaxAmount: description: Monto mínimo del receptor en reales (pisoValorMaximo). format: double type: number frequency: description: tpFrequencia (0=Weekly,1=Monthly,2=Quarterly,3=Semiannual,4=Annual). format: int64 type: integer idRecorrencia: description: Id de recurrencia único (29 caracteres, formato RR...). type: string payer: $ref: '#/components/schemas/AuthorizationPayerBody' recipient: $ref: '#/components/schemas/AuthorizationRecipientBody' solicitationDateTime: description: >- Marca de tiempo de creación de la solicitud (dtHrCriacaoSolicitacao, UTC). type: string startDate: description: Fecha del primer pago (dtInicialRecorrencia; aaaa-mm-dd). type: string required: - idRecorrencia - frequency - startDate - recipient - payer - contractNumber type: object RequestAuthorizationResponse: additionalProperties: false properties: idRecorrencia: description: El id de recurrencia (reflejado). type: string idReqJdPi: description: El id de solicitud del upstream (GUID de 36 caracteres). type: string requestedAt: description: >- Marca de tiempo de la solicitud en el upstream (marca de tiempo de la solicitud del upstream, UTC). type: string status: description: El estado local resultante de la autorización. type: string required: - idReqJdPi - idRecorrencia - requestedAt - status type: object Detail: additionalProperties: false properties: code: description: >- Código de error de dominio estable y legible por máquina, acotado al servicio emisor (formato: -NNNN). type: string detail: description: >- Una explicación legible para humanos específica de esta ocurrencia del problema. type: string errors: description: Lista opcional de detalles de error individuales items: $ref: '#/components/schemas/ErrorDetail' type: array nullable: true instance: description: >- Una referencia URI que identifica la ocurrencia específica del problema. format: uri type: string status: description: Código de estado HTTP format: int64 type: integer title: description: >- Un resumen breve y legible para humanos del tipo de problema. Este valor no debería cambiar entre ocurrencias del error. type: string type: default: about:blank description: >- Una referencia URI a la documentación legible para humanos del error. format: uri type: string type: object AuthorizationDebtorBody: additionalProperties: false properties: cpfCnpj: description: CPF o CNPJ del deudor (cadena). type: string name: description: Nombre del deudor. type: string personType: description: tpPessoa (0=Pessoa Fisica, 1=Pessoa Juridica). format: int64 type: integer required: - personType - cpfCnpj - name type: object AuthorizationPayerBody: additionalProperties: false properties: account: description: Número de cuenta del pagador (nrConta, cadena). type: string agency: description: Agencia del pagador (nrAgencia, 4 dígitos, cadena). type: string cpfCnpj: description: CPF o CNPJ del pagador (cadena). type: string ispb: description: ISPB del participante pagador (8 dígitos, cadena). type: string personType: description: tpPessoa (0=Pessoa Fisica, 1=Pessoa Juridica). format: int64 type: integer required: - ispb - personType - cpfCnpj - account type: object AuthorizationRecipientBody: additionalProperties: false properties: cnpj: description: CNPJ del beneficiario (14 dígitos, cadena). type: string ispb: description: ISPB del participante beneficiario (8 dígitos, cadena). type: string name: description: Razón social / nombre comercial del beneficiario. type: string required: - ispb - cnpj - name type: object ErrorDetail: additionalProperties: false properties: location: description: >- Dónde ocurrió el error, p. ej. 'body.items[3].tags' o 'path.thing-id' type: string message: description: Texto del mensaje de error type: string value: description: El valor en la ubicación indicada type: object securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: > Autenticación con token JWT Bearer. Obtén el token desde el endpoint `/v1/login/oauth/access_token` usando credenciales de cliente (`clientId` y `clientSecret`). Incluye el token en el encabezado Authorization: `Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...` El token expira después de 3600 segundos (1 hora). ````