---
title: "Criação de Agendamento Recorrente."
method: POST
path: "/pix/scheduling-payments/recurrences"
tags: ["Pix agendado"]
---

# Criação de Agendamento Recorrente.

`POST /pix/scheduling-payments/recurrences`

Utilize este endpoint para criar agendamentos recorrentes.

## Parameters

- `#/paths/~1pix~1claims/get/parameters/0` — unresolved $ref
- `#/paths/~1pix~1claims/get/parameters/2` — unresolved $ref
- `#/paths/~1pix~1claims/get/parameters/3` — unresolved $ref
- `#/paths/~1pix~1recurring-payments/get/parameters/10` — unresolved $ref

## Request body

- CreateRecurringSchedulePaymentPayload
  - `requestDateTime` string, date-time — Data e hora que o usuário solicitou o agendamento recorrente.
  - `payment` object — Dados do pagamento.
    - `initiationForm` 'DICT' | 'MANU' — Forma de iniciação do agendamento recorrente.
    - `interbankSettlementAmount` string, float — Valores dos agendamentos da recorrência.
    - `remittanceInformation` string, nullable — Informações do usuário pagador para o usuário recebedor.
    - `endToEndId` string — Identificador fim-a-fim do agendamento. Obrigatório quando <b>initiationForm</b> for igual a <b>DICT</b>.
    - `creditor` CreditorSchedulePaymentPayload — Dados da conta recebedora.
      - `accountIdentification` string, required — Dados da conta recebedora. Obrigatório somente quando <b>initiationForm</b> for igual a <b>MANU</b>.
      - `accountIssuer` string, required — Agência do cliente recebedor. Obrigatório somente quando <b>initiationForm</b> for igual a <b>MANU</b>.
      - `accountType` 'CACC' | 'TRAN' | 'SVGS', required — Tipo de conta. Obrigatório somente quando <b>initiationForm</b> for igual a <b>MANU</b>.
      - `agentMemberIdentification` string, required — ISPB do banco do cliente recebedor. Obrigatório somente quando <b>initiationForm</b> for igual a <b>MANU</b>.
      - `name` string, required — Nome do recebedor. Obrigatório somente quando <b>initiationForm</b> for igual a <b>MANU</b>.
      - `privateIdentification` string, required — CPF ou CNPJ do cliente recebedor. Obrigatório somente quando <b>initiationForm</b> for igual a <b>MANU</b>. `^([0-9]{11}|[A-Z0-9]{12}[0-9]{2})$`
    - `debtor` DebtorSchedulePaymentPayload — Dados da conta pagadora.
      - `accountIdentification` string, required — Conta do cliente pagador.
      - `accountIssuer` string, required — Agência do cliente pagador.
      - `accountType` 'CACC' | 'TRAN' | 'SVGS', required — Tipo de conta pagadora.
      - `name` string, required — Nome do pagador.
      - `privateIdentification` string, required — CPF ou CNPJ do cliente pagador. `^([0-9]{11}|[A-Z0-9]{12}[0-9]{2})$`.
  - `recurrence` object — Dados da recorrência.
    - `frequency` 'WEEKLY' | 'MONTHLY' | 'YEARLY' — Frequência da recorrência.
    - `initialDateSchedule` string, date — Data de início da recorrência, ou seja, data do primeiro pagamento.
    - `finalDateSchedule` string, date, nullable — Data de fim da recorrência, ou seja, data do último agendamento.
    - `repetition` integer, nullable — Quantidade de repetições da recorrência.
    - `description` string, nullable — Descrição da recorrência.
    - `invalidDatePayment` 'ANTICIPATE' | 'POSTPONE' — Indica se o agendamento deve ser antecipado ou postergado em caso de data inexistente (ex. dias 29 e 31).

## Response `202`

Sucesso na criação do agendamento recorrente.

- object
  - `recurrence` object — Recorrência.
    - `requestIdentifier` string — Identificador da recorrência.
  - `message` string — Mensagem de sucesso.

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `403` — unresolved $ref
- `422` — unresolved $ref
- `500` — unresolved $ref

---

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