Pix Automático | Notificações de Agendamento

Após a autorização concedida pelo usuário pagador por meio de uma das jornadas previstas (AUT1, AUT2, AUT3 ou AUT4), nenhuma ação adicional é necessária por parte do parceiro integrador da Bankly para que os agendamentos sejam criados.
O fluxo funciona da seguinte forma:

O PSP do recebedor deve enviar a instrução de pagamento entre 2 e 10 dias antes da data de liquidação informada no momento da autorização.
Ao receber essa instrução, o core da Bankly gera automaticamente o agendamento, sem necessidade de qualquer chamada adicional ou intervenção do parceiro integrador.
Sempre que um novo agendamento for criado, o parceiro será notificado por meio dos eventos do Pix Automático, que trazem os detalhes do agendamento e seu status.

Dessa forma, o parceiro integrador precisa apenas consumir os eventos de notificação para acompanhar a criação e evolução dos agendamentos — todo o processo de geração é automatizado e acionado exclusivamente pela instrução enviada pelo recebedor.

PIX_AUTOMATIC_PAYMENT_WAS_SCHEDULED

Este evento sinaliza que o agendamento foi realizado com sucesso.

Descrição do objeto data do evento

O objeto data traz detalhes específicos do contexto em que o evento ocorre. Neste caso, o objeto trará os campos de acordo com a tabela:

Nome	Tipo	Obrigatoriedade	Descrição
`code`	`string`	Obrigatório	Código da notificação. Nesse caso será o code 1528
`reason`	`string`	Obrigatório	Motivo da notificação.
`isPixOpenBanking`	`boolean`	Obrigatório	Transação iniciada por Open Finance.
`recurrence`	`object`	Obrigatório	Objeto que contém os dados referentes à recorrência.
`recurrence.requestIdentifier`	`string`	Obrigatório	Identificador único da recorrência.
`schedule`	`object`	Obrigatório	Objeto que contem os dados do agendamento.
`schedule.endToEndId`	`string`	Obrigatório	Identificador da Transação.
`schedule.dateSchedule`	`date`	Obrigatório	Data de liquidação do agendamento.
`schedule.expirationDate`	`date`	Obrigatório	Data de vencimento do agendamento.
`schedule.status`	`string`	Obrigatório	Status do agendamento: `SCHEDULED` - Agendado
`schedule.transactionIdentification`	`string`	Obrigatório	Identificador da transação (txid).
`schedule.purpose`	`string`	Obrigatório	Tipo do agendamento: `AGND` - Primeiro agendamento `RIFL` - Retentativa de agendamento pós falha `NTAG` - Retentativa pós vencimento
`schedule.finalAttempt`	`boolean`	Opcional	Indica se a notificação atual corresponde à última tentativa de liquidação do agendamento, ou seja, se não haverá novas retentativas nos próximos dias. Para agendamentos originais (`AGND`) que falharam na liquidação e não permitem retentativas após o vencimento, o campo será `true`. Para agendamentos de retentativa (`NTAG`), o campo será `true` apenas quando o agendamento representar a última retentativa configurada.
`schedule.amount`	`number`	Obrigatório	Valor do agendamento.
`schedule.description`	`string`	Obrigatório	Descrição do agendamento.
`schedule.creditor`	`object`	Obrigatório	Objeto que contém os dados do recebedor do agendamento.
`schedule.creditor.name`	`string`	Obrigatório	Nome do recebedor.
`schedule.creditor.privateIdentification`	`string`	Obrigatório	CNPJ do cliente recebedor.
`schedule.creditor.account`	`object`	Obrigatório	Objeto que contém os dados da conta do cliente recebedor.
`schedule.creditor.account.branch`	`string`	Obrigatório	Número da agência do recebedor.
`schedule.creditor.account.number`	`string`	Obrigatório	Número da conta do recebedor.
`schedule.creditor.account.participant`	`string`	Obrigatório	ISPB do banco do cliente recebedor.
`schedule.creditor.account.type`	`string`	Obrigatório	Tipo de conta do cliente recebedor. `CACC` - Conta corrente `SVGS` - Conta de Poupança. `TRAN` - Conta de Pagamento.
`schedule.debtor`	`object`	Obrigatório	Objeto que contém os dados da conta do cliente pagador.
`schedule.debtor.name`	`string`	Obrigatório	Nome do pagador.
`schedule.debtor.privateIdentification`	`string`	Obrigatório	CPF ou CNPJ do cliente pagador.
`schedule.debtor.account`	`object`	Obrigatório	Objeto que contém os dados da conta do cliente pagador.
`schedule.debtor.account.branch`	`string`	Obrigatório	Número da agência do pagador.
`schedule.debtor.account.number`	`string`	Obrigatório	Número da conta do pagador.
`schedule.debtor.account.participant`	`string`	Obrigatório	ISPB do banco do cliente pagador.
`schedule.debtor.account.type`	`string`	Obrigatório	Tipo de conta do cliente recebedor. `CACC` - Conta corrente `SVGS` - Conta de Poupança. `TRAN` - Conta de Pagamento.
`schedule.debtor.account.companyKey`	`string`	Obrigatório	Chave que identifica o parceiro dentro do Bankly.

Payload do evento

O payload abaixo exemplifica a estrutura do evento que deverá ser recebido pelo parceiro. Clique na seta para expandi-lo:

Exemplo de payload

{
  "entityId": "SC131400882025052972I0WCAUTOM",
  "companyKey": "AUTOMATED_TESTS",
  "idempotencyKey": "bf66caa3-bdfe-4b4e-a265-dd3f11f01525",
  "context": "Pix",
  "metadata": {},
  "name": "PIX_AUTOMATIC_PAYMENT_WAS_SCHEDULED",
  "timestamp": "2025-08-15T13:13:04.7486251Z",
  "correlationId": "cff39660-c365-4e6c-aed3-224ab2bd466f",
  "data": {
    "code": "1528",
    "isPixOpenBanking": false,
    "reason": "Pagamento agendado com sucesso",
    "recurrence": {
      "requestIdentifier": "RAxxxxxxxxyyyyMMddkkkkkkkkkkk"
    },
    "schedule": {
      "endToEndId": "ExxxxxxxxyyyyMMddHHmmkkkkkkkkkkk",
      "dateSchedule": "2025-01-01",
      "expirationDate": "2025-01-01",
      "status": "SCHEDULED",
      "transactionIdentification": "asdjaskdljasdkajdlkajsdlasdjkl",
      "purpose": "AGND",
      "finalAttempt": true,
      "amount": 1.99,
      "description": "teste de recorrencia",
      "creditor": {
        "name": "RECEBEDOR",
        "privateIdentification": "12312312312",
        "account": {
          "branch": "1234",
          "number": "123456",
          "participant": "12345678",
          "type": "CACC"
        }
      },
      "debtor": {
        "name": "PAGADOR",
        "privateIdentification": "45645645645",
        "account": {
          "branch": "1234",
          "number": "123456",
          "participant": "12345678",
          "type": "CACC",
          "companyKey": "AUTOMATED_TESTS_SDB"
        }
      }
    }
  },
  "version": "1.0",
  "licenseUuid": "70141cc1-03aa-484e-a3be-ee63c56fb9b7",
  "licenses": [
    {
      "id": "70141cc1-03aa-484e-a3be-ee63c56fb9b7",
      "provider": "BCO BV S.A.",
      "types": ["Banking"]
    }
  ]
}

Código(s) de agendamento pix automático (Code)

O evento PIX_AUTOMATIC_PAYMENT_WAS_SCHEDULED pode receber o seguinte código no campo code, referentes ao agendamento:

Código	Descrição
1528	Pagamento agendado com sucesso.

📘
Para esta notificação o schedule.status será sempre SCHEDULED
O schedule.purpose pode ter qualquer um dos 3 valores:
AGND - Primeiro agendamento
RIFL - Retentativa de agendamento pós falha no primeiro agendamento
NTAG - Retentativa pós vencimento

PIX_AUTOMATIC_SCHEDULE_PAYMENT_WAS_CANCELED

Este evento sinaliza que o agendamento do pagamento foi CANCELADO a pedido do Recebedor.

Descrição do objeto data do evento

O objeto data traz detalhes específicos do contexto em que o evento ocorre. Neste caso, o objeto trará os campos de acordo com a tabela:

Nome	Tipo	Obrigatoriedade	Descrição
`code`	`string`	Obrigatório	Código da notificação. Nesse caso será o code 1530
`reason`	`string`	Obrigatório	Motivo da notificação.
`recurrence`	`object`	Obrigatório	Objeto que contém os dados referentes à recorrência.
`recurrence.requestIdentifier`	`string`	Obrigatório	Identificador único da recorrência
`schedule`	`object`	Obrigatório	Objeto que contem os dados do agendamento
`schedule.endToEndId`	`string`	Obrigatório	Identificador da Transação
`schedule.dateSchedule`	`date`	Obrigatório	Data de liquidação do agendamento.
`schedule.expirationDate`	`date`	Obrigatório	Data de vencimento do agendamento.
`schedule.status`	`string`	Obrigatório	Status do agendamento: `CANCELED` - Pagamento cancelado
`schedule.transactionIdentification`	`string`	Obrigatório	Identificador da transação (txid)
`schedule.purpose`	`string`	Obrigatório	Tipo do agendamento: `AGND` - Primeiro agendamento `RIFL` - Retentativa de agendamento pós falha `NTAG` - Retentativa pós vencimento
`schedule.amount`	`number`	Obrigatório	Valor do agendamento.
`schedule.description`	`string`	Opcional	Descrição do agendamento.
`schedule.creditor`	`object`	Obrigatório	Objeto que contém os dados do recebedor do agendamento.
`schedule.creditor.name`	`string`	Obrigatório	Nome do recebedor.
`schedule.creditor.privateIdentification`	`string`	Obrigatório	CNPJ do cliente recebedor.
`schedule.creditor.account`	`object`	Obrigatório	Objeto que contém os dados da conta do cliente recebedor.
`schedule.creditor.account.participant`	`string`	Obrigatório	ISPB do banco do cliente recebedor.
`schedule.debtor`	`object`	Obrigatório	Objeto que contém os dados da conta do cliente pagador.
`schedule.debtor.name`	`string`	Obrigatório	Nome do pagador.
`schedule.debtor.privateIdentification`	`string`	Obrigatório	CNPJ do cliente pagador.
`schedule.debtor.account`	`object`	Obrigatório	Objeto que contém os dados da conta do cliente pagador.
`schedule.debtor.account.branch`	`string`	Obrigatório	Número da agência do pagador.
`schedule.debtor.account.number`	`string`	Obrigatório	Número da conta do pagador.
`schedule.debtor.account.participant`	`string`	Obrigatório	ISPB do banco do cliente pagador.
`schedule.debtor.account.companyKey`	`string`	Obrigatório	Chave que identifica o parceiro dentro do Bankly

Payload do evento

O payload abaixo exemplifica a estrutura do evento que deverá ser recebido pelo parceiro. Clique na seta para expandi-lo:

Exemplo de payload

{
  "entityId": "SC131400882025052972I0WCAUTOM",
  "companyKey": "AUTOMATED_TESTS",
  "idempotencyKey": "bf66caa3-bdfe-4b4e-a265-dd3f11f01525",
  "context": "Pix",
  "metadata": {},
  "name": "PIX_AUTOMATIC_SCHEDULE_PAYMENT_WAS_CANCELED",
  "timestamp": "2025-08-15T13:13:04.7486251Z",
  "correlationId": "cff39660-c365-4e6c-aed3-224ab2bd466f",
  "data": {
    "reason": "Cancelamento de agendamento solicitado pelo Recebedor efetuado com sucesso",
    "code": "1530",
    "recurrence": {
      "requestIdentifier": "RAxxxxxxxxyyyyMMddkkkkkkkkkkk"
    },
    "schedule": {
      "endToEndId": "ExxxxxxxxyyyyMMddHHmmkkkkkkkkkkk",
      "dateSchedule": "2025-01-01",
      "expirationDate": "2025-01-01",
        "status": "CANCELED",
      "transactionIdentification": "asdjaskdljasdkajdlkajsdlasdjkl",
      "purpose": "AGND",
      "amount": 1.99,
      "description": "teste de recorrencia",
      "creditor": {
        "name": "RECEBEDOR",
        "privateIdentification": "12312312312",
        "account": {
          "participant": "12345678"
        }
      },
      "debtor": {
        "name": "PAGADOR",
        "privateIdentification": "45645645645",
        "account": {
          "branch": "1234",
          "number": "123456",
          "participant": "12345678",
  					"companyKey": "AUTOMATED_TESTS_SDB"
        }
      }
    }
  },
  "version": "1.0",
  "licenseUuid": "70141cc1-03aa-484e-a3be-ee63c56fb9b7",
  "licenses": [
    {
      "id": "70141cc1-03aa-484e-a3be-ee63c56fb9b7",
      "provider": "BCO BV S.A.",
      "types": ["Banking"]
    }
  ]
}

Código(s) de agendamento pix automático (Code)

O evento PIX_AUTOMATIC_SCHEDULE_PAYMENT_WAS_CANCELED pode receber o seguinte código no campo code, referentes ao cancelamento:

Código	Descrição
1530	Cancelamento de agendamento solicitado pelo Recebedor efetuado com sucesso.

PIX_AUTOMATIC_SCHEDULE_PAYMENT_WAS_FAILED

Este evento sinaliza os possíveis motivos para insucesso na liquidação do pagamento para o Pix Automático.

Descrição do objeto data do evento

O objeto data traz detalhes específicos do contexto em que o evento ocorre. Neste caso, o objeto trará os campos de acordo com a tabela:

Nome	Tipo	Obrigatoriedade	Descrição
`code`	`string`	Obrigatório	Código da notificação.
`reason`	`string`	Obrigatório	Motivo da notificação.
`isPixOpenBanking`	`boolean`	Obrigatório	Transação iniciada por Open Finance
`recurrence`	`object`	Obrigatório	Objeto que contém os dados referentes à recorrência.
`recurrence.requestIdentifier`	`string`	Obrigatório	Identificador único da recorrência
`schedule`	`object`	Obrigatório	Objeto que contem os dados do agendamento
`schedule.endToEndId`	`string`	Opcional	Identificador da Transação. Obrigatório somente nas jornadas 2, 3 e 4
`schedule.dateSchedule`	`date`	Obrigatório	Data de liquidação do agendamento.
`schedule.expirationDate`	`date`	Obrigatório	Data de vencimento do agendamento.
`schedule.status`	`string`	Obrigatório	Status do agendamento: `RESCHEDULED` - Reagendado `ERROR` - Erro no pagamento
`schedule.transactionIdentification`	`string`	Obrigatório	Identificador da transação (txid)
`schedule.purpose`	`string`	Obrigatório	Tipo do agendamento: `AGND` - Primeiro agendamento `RIFL` - Retentativa de agendamento pós falha `NTAG` - Retentativa pós vencimento
`schedule.finalAttempt`	`boolean`	Obrigatório	Indica se a notificação atual corresponde à última tentativa de liquidação do agendamento, ou seja, se não haverá novas retentativas nos próximos dias. Para agendamentos originais (`AGND`) que falharam na liquidação e não permitem retentativas após o vencimento, o campo será `true`. Para agendamentos de retentativa (`NTAG`), o campo será `true` apenas quando o agendamento representar a última retentativa configurada.
`schedule.amount`	`number`	Obrigatório	Valor do agendamento.
`schedule.description`	`string`	Opcional	Descrição do agendamento.
`schedule.paymentInitiator`	`string`	Opcional	CNPJ do iniciador de pagamento
`schedule.creditor`	`object`	Obrigatório	Objeto que contém os dados do recebedor do agendamento.
`schedule.creditor.name`	`string`	Obrigatório	Nome do recebedor.
`schedule.creditor.privateIdentification`	`string`	Obrigatório	CNPJ do cliente recebedor.
`schedule.creditor.account`	`object`	Obrigatório	Objeto que contém os dados da conta do cliente recebedor.
`schedule.creditor.account.branch`	`string`	Obrigatório	Número da agência do recebedor.
`schedule.creditor.account.number`	`string`	Obrigatório	Número da conta do recebedor.
`schedule.creditor.account.participant`	`string`	Obrigatório	ISPB do banco do cliente recebedor.
`schedule.creditor.account.type`	`string`	Obrigatório	Tipo de conta do cliente recebedor. `CACC` - Conta corrente `SVGS` - Conta de Poupança. `TRAN` - Conta de Pagamento.
`schedule.debtor`	`object`	Obrigatório	Objeto que contém os dados da conta do cliente pagador.
`schedule.debtor.name`	`string`	Obrigatório	Nome do pagador.
`schedule.debtor.privateIdentification`	`string`	Obrigatório	CNPJ do cliente pagador.
`schedule.debtor.account`	`object`	Obrigatório	Objeto que contém os dados da conta do cliente pagador.
`schedule.debtor.account.branch`	`string`	Obrigatório	Número da agência do pagador.
`schedule.debtor.account.number`	`string`	Obrigatório	Número da conta do pagador.
`schedule.debtor.account.participant`	`string`	Obrigatório	ISPB do banco do cliente pagador.
`schedule.debtor.account.type`	`string`	Obrigatório	Tipo de conta do cliente pagador. `CACC` - Conta corrente `SVGS` - Conta de Poupança. `TRAN` - Conta de Pagamento.
`schedule.debtor.account.companyKey`	`string`	Obrigatório	Chave que identifica o parceiro dentro do Bankly.

Payload do evento

O payload abaixo exemplifica a estrutura do evento que deverá ser recebido pelo parceiro. Clique na seta para expandi-lo:

Exemplo de payload

{
  "data": {
    "reason": "O valor do agendamento excedeu o valor máximo autorizado",
    "recurrence": {
      "requestIdentifier": "RA123456782025073112345678912"
    },
    "schedule": {
      "endToEndId": "E1234567820250731163412345678912",
      "dateSchedule": "2025-08-01",
      "expirationDate": "2025-08-04",
      "status": "ERROR",
      "transactionIdentification": "b3492d8b-adde-413e-9b31-46ffce160f18",
      "purpose": "AGND",
      "finalAttempt": true,
      "amount": 1.99,
      "description": "teste de notificação de agendamento de recorrência",
      "creditor": {
        "name": "RECEBEDOR",
        "privateIdentification": "28173336407",
        "account": {
          "branch": "2020",
          "number": "502001605796",
          "participant": "01858774",
          "type": "CACC"
        }
      },
      "debtor": {
        "name": "Joann Roberts",
        "privateIdentification": "52853664619",
        "account": {
          "branch": "0001",
          "number": "1104802861",
          "participant": "13140088",
          "type": "TRAN",
          "companyKey": "AUTOMATED_TESTS_SDB"
        }
      }
    },
    "code": "1515",
    "isPixOpenBanking": false
  },
  "entityId": "SC131400882025052972I0WC2KCIN",
  "companyKey": "AUTOMATED_TESTS_SDB",
  "idempotencyKey": "90b5872a-5f13-5aa1-8ccf-7dc002b53977",
  "licenses": [
    {
      "id": "25bcb44c-992c-4cfa-98ef-d344c1ce838a",
      "provider": "ACESSO SOLUÇÕES DE PAGAMENTO S.A. - INSTITUIÇÃO DE PAGAMENTO",
      "types": [
        "Banking"
      ]
    }
  ],
  "licenseUuid": "25bcb44c-992c-4cfa-98ef-d344c1ce838a",
  "context": "Pix",
  "name": "PIX_AUTOMATIC_SCHEDULE_PAYMENT_WAS_FAILED",
  "version": "1",
  "timestamp": "2025-05-30T12:52:07.7159378",
  "correlationId": "03325537-3d99-4e1d-b5fa-e954745bd449"
}

{
  "data": {
    "reason": "TRANSFER_ORDER_NOT_PROCESSED",
    "recurrence": {
      "requestIdentifier": "RA131400882025080411112233445"
    },
    "schedule": {
      "endToEndId": "E131400882025080411112233445",
      "dateSchedule": "2025-08-04",
      "expirationDate": "2025-08-05",
      "status": "ERROR",
      "transactionIdentification": "b3492d8b-adde-413e-9b31-46ffce160f18",
      "purpose": "AGND",
      "finalAttempt": true,
      "amount": 1.99,
      "description": "Automation Test 5e0bc2c0-692b-4782-8fca-327426e67a00",
      "creditor": {
        "name": "RECEBEDOR TESTE",
        "privateIdentification": "28173336407",
        "account": {
          "branch": "2020",
          "number": "502001605796",
          "participant": "01858774",
          "type": "CACC"
        }
      },
      "debtor": {
        "name": "PAGADOR TESTE",
        "privateIdentification": "52853664619",
        "account": {
          "branch": "0001",
          "number": "1104802861",
          "participant": "13140088",
          "type": "TRAN",
          "companyKey": "AUTOMATED_TESTS_SDB"
        }
      }
    },
    "name": "PIX_AUTOMATIC_SCHEDULE_PAYMENT_WAS_FAILED",
    "code": "9916",
    "isPixOpenBanking": false
  },
  "entityId": "SC131400882025052972I0WCAUTOM",
  "companyKey": "AUTOMATED_TESTS_SDB",
  "idempotencyKey": "e10d0fda-5844-5df9-96f3-734115a301a3",
  "licenses": [
    {
      "id": "25bcb44c-992c-4cfa-98ef-d344c1ce838a",
      "provider": "ACESSO SOLUÇÕES DE PAGAMENTO S.A. - INSTITUIÇÃO DE PAGAMENTO",
      "types": [
        "Banking"
      ]
    }
  ],
  "licenseUuid": "25bcb44c-992c-4cfa-98ef-d344c1ce838a",
  "context": "Pix",
  "name": "PIX_AUTOMATIC_SCHEDULE_PAYMENT_WAS_FAILED",
  "version": "1",
  "timestamp": "2025-05-30T12:52:07.71",
  "correlationId": "316b8b5a-0ba5-436a-87a9-9b618a66abda"
}

{
  "data": {
    "reason": "TRANSFER_ORDER_NOT_PROCESSED",
    "recurrence": {
      "requestIdentifier": "RA131400882025080411112233445"
    },
    "schedule": {
      "endToEndId": "E131400882025080411112233445",
      "dateSchedule": "2025-08-04",
      "expirationDate": "2025-08-05",
      "status": "ERROR",
      "transactionIdentification": "b3492d8b-adde-413e-9b31-46ffce160f18",
      "purpose": "AGND",
      "finalAttempt": true,
      "amount": 1.99,
      "description": "Automation Test ae83a017-5f3e-4372-bc6f-4763f48c227f",
      "creditor": {
        "name": "RECEBEDOR TESTE",
        "privateIdentification": "28173336407",
        "account": {
          "branch": "2020",
          "number": "502001605796",
          "participant": "01858774",
          "type": "CACC"
        }
      },
      "debtor": {
        "name": "PAGADOR TESTE",
        "privateIdentification": "52853664619",
        "account": {
          "branch": "0001",
          "number": "1104802861",
          "participant": "13140088",
          "type": "TRAN",
          "companyKey": "AUTOMATED_TESTS_SDB"
        }
      }
    },
    "name": "PIX_AUTOMATIC_SCHEDULE_PAYMENT_WAS_FAILED",
    "code": "1531",
    "isPixOpenBanking": false
  },
  "entityId": "SC131400882025052972I0WCAUTOM",
  "companyKey": "AUTOMATED_TESTS_SDB",
  "idempotencyKey": "e10d0fda-5844-5df9-96f3-734115a301a3",
  "licenses": [
    {
      "id": "25bcb44c-992c-4cfa-98ef-d344c1ce838a",
      "provider": "ACESSO SOLUÇÕES DE PAGAMENTO S.A. - INSTITUIÇÃO DE PAGAMENTO",
      "types": [
        "Banking"
      ]
    }
  ],
  "licenseUuid": "25bcb44c-992c-4cfa-98ef-d344c1ce838a",
  "context": "Pix",
  "name": "PIX_AUTOMATIC_SCHEDULE_PAYMENT_WAS_FAILED",
  "version": "1",
  "timestamp": "2025-05-30T12:52:07.71",
  "correlationId": "05a77068-76d5-4719-852f-5bccc19b420c"
}

{
  "data": {
    "reason": "SENDER_ACCOUNT_STATUS_NOT_ALLOW_CASH_OUT",
    "recurrence": {
      "requestIdentifier": "RA131400882025080411112233445"
    },
    "schedule": {
      "endToEndId": "E131400882025080411112233445",
      "dateSchedule": "2025-08-04",
      "expirationDate": "2025-08-05",
      "status": "RESCHEDULED",
      "transactionIdentification": "b3492d8b-adde-413e-9b31-46ffce160f18",
      "purpose": "AGND",
      "finalAttempt": true,
      "amount": 1.99,
      "description": "Automation Test 10746a92-8828-44d8-b1d0-0cd54d1d7253",
      "creditor": {
        "name": "RECEBEDOR TESTE",
        "privateIdentification": "28173336407",
        "account": {
          "branch": "2020",
          "number": "502001605796",
          "participant": "01858774",
          "type": "CACC"
        }
      },
      "debtor": {
        "name": "PAGADOR TESTE",
        "privateIdentification": "52853664619",
        "account": {
          "branch": "0001",
          "number": "1104802861",
          "participant": "13140088",
          "type": "TRAN",
          "companyKey": "AUTOMATED_TESTS_SDB"
        }
      }
    },
    "name": "PIX_AUTOMATIC_SCHEDULE_PAYMENT_WAS_FAILED",
    "code": "9912",
    "isPixOpenBanking": false
  },
  "entityId": "SC131400882025052972I0WCAUTOM",
  "companyKey": "AUTOMATED_TESTS_SDB",
  "idempotencyKey": "e10d0fda-5844-5df9-96f3-734115a301a3",
  "licenses": [
    {
      "id": "25bcb44c-992c-4cfa-98ef-d344c1ce838a",
      "provider": "ACESSO SOLUÇÕES DE PAGAMENTO S.A. - INSTITUIÇÃO DE PAGAMENTO",
      "types": [
        "Banking"
      ]
    }
  ],
  "licenseUuid": "25bcb44c-992c-4cfa-98ef-d344c1ce838a",
  "context": "Pix",
  "name": "PIX_AUTOMATIC_SCHEDULE_PAYMENT_WAS_FAILED",
  "version": "1",
  "timestamp": "2025-05-30T12:52:07.71",
  "correlationId": "abec0c79-9e34-4e58-a46b-fc0d75e9054e"
}

{
  "data": {
    "reason": "INSUFFICIENT_BALANCE",
    "recurrence": {
      "requestIdentifier": "RA131400882025080411112233445"
    },
    "schedule": {
      "endToEndId": "E131400882025080411112233445",
      "dateSchedule": "2025-08-04",
      "expirationDate": "2025-08-05",
      "status": "RESCHEDULED",
      "transactionIdentification": "b3492d8b-adde-413e-9b31-46ffce160f18",
      "purpose": "AGND",
      "finalAttempt": true,
      "amount": 1.99,
      "description": "Automation Test a91efe1b-e33a-4c63-8b52-05107b619065",
      "creditor": {
        "name": "RECEBEDOR TESTE",
        "privateIdentification": "28173336407",
        "account": {
          "branch": "2020",
          "number": "502001605796",
          "participant": "01858774",
          "type": "CACC"
        }
      },
      "debtor": {
        "name": "PAGADOR TESTE",
        "privateIdentification": "52853664619",
        "account": {
          "branch": "0001",
          "number": "1104802861",
          "participant": "13140088",
          "type": "TRAN",
          "companyKey": "AUTOMATED_TESTS_SDB"
        }
      }
    },
    "name": "PIX_AUTOMATIC_SCHEDULE_PAYMENT_WAS_FAILED",
    "code": "9914",
    "isPixOpenBanking": false
  },
  "entityId": "SC131400882025052972I0WCAUTOM",
  "companyKey": "AUTOMATED_TESTS_SDB",
  "idempotencyKey": "e10d0fda-5844-5df9-96f3-734115a301a3",
  "licenses": [
    {
      "id": "25bcb44c-992c-4cfa-98ef-d344c1ce838a",
      "provider": "ACESSO SOLUÇÕES DE PAGAMENTO S.A. - INSTITUIÇÃO DE PAGAMENTO",
      "types": [
        "Banking"
      ]
    }
  ],
  "licenseUuid": "25bcb44c-992c-4cfa-98ef-d344c1ce838a",
  "context": "Pix",
  "name": "PIX_AUTOMATIC_SCHEDULE_PAYMENT_WAS_FAILED",
  "version": "1",
  "timestamp": "2025-05-30T12:52:07.71",
  "correlationId": "263669d6-46e7-4abe-b62c-b11831e541ef"
}

{
  "data": {
    "reason": "INSUFFICIENT_BALANCE",
    "recurrence": {
      "requestIdentifier": "RA131400882025080411112233445"
    },
    "schedule": {
      "endToEndId": "E131400882025080411112233445",
      "dateSchedule": "2025-08-04",
      "expirationDate": "2025-08-05",
      "status": "ERROR",
      "transactionIdentification": "b3492d8b-adde-413e-9b31-46ffce160f18",
      "purpose": "AGND",
      "finalAttempt": true,
      "amount": 1.99,
      "description": "Automation Test 81a0b455-c5ea-47dd-825e-4a1994ed6704",
      "creditor": {
        "name": "RECEBEDOR TESTE",
        "privateIdentification": "28173336407",
        "account": {
          "branch": "2020",
          "number": "502001605796",
          "participant": "01858774",
          "type": "CACC"
        }
      },
      "debtor": {
        "name": "PAGADOR TESTE",
        "privateIdentification": "52853664619",
        "account": {
          "branch": "0001",
          "number": "1104802861",
          "participant": "13140088",
          "type": "TRAN",
          "companyKey": "AUTOMATED_TESTS_SDB"
        }
      }
    },
    "name": "PIX_AUTOMATIC_SCHEDULE_PAYMENT_WAS_FAILED",
    "code": "9915",
    "isPixOpenBanking": false
  },
  "entityId": "SC131400882025052972I0WCAUTOM",
  "companyKey": "AUTOMATED_TESTS_SDB",
  "idempotencyKey": "e10d0fda-5844-5df9-96f3-734115a301a3",
  "licenses": [
    {
      "id": "25bcb44c-992c-4cfa-98ef-d344c1ce838a",
      "provider": "ACESSO SOLUÇÕES DE PAGAMENTO S.A. - INSTITUIÇÃO DE PAGAMENTO",
      "types": [
        "Banking"
      ]
    }
  ],
  "licenseUuid": "25bcb44c-992c-4cfa-98ef-d344c1ce838a",
  "context": "Pix",
  "name": "PIX_AUTOMATIC_SCHEDULE_PAYMENT_WAS_FAILED",
  "version": "1",
  "timestamp": "2025-05-30T12:52:07.71",
  "correlationId": "97f06439-00e9-40ec-ae97-7851653f51a0"
}

{
  "data": {
    "reason": "TRANSFER_ORDER_NOT_PROCESSED",
    "recurrence": {
      "requestIdentifier": "RA131400882025080411112233445"
    },
    "schedule": {
      "endToEndId": "E131400882025080411112233445",
      "dateSchedule": "2025-08-04",
      "expirationDate": "2025-08-05",
      "status": "ERROR",
      "transactionIdentification": "b3492d8b-adde-413e-9b31-46ffce160f18",
      "purpose": "AGND",
      "finalAttempt": true,
      "amount": 1.99,
      "description": "Automation Test 81976909-0f36-46ad-9abc-83fd6fda664c",
      "creditor": {
        "name": "RECEBEDOR TESTE",
        "privateIdentification": "28173336407",
        "account": {
          "branch": "2020",
          "number": "502001605796",
          "participant": "01858774",
          "type": "CACC"
        }
      },
      "debtor": {
        "name": "PAGADOR TESTE",
        "privateIdentification": "52853664619",
        "account": {
          "branch": "0001",
          "number": "1104802861",
          "participant": "13140088",
          "type": "TRAN",
          "companyKey": "AUTOMATED_TESTS_SDB"
        }
      }
    },
    "name": "PIX_AUTOMATIC_SCHEDULE_PAYMENT_WAS_FAILED",
    "code": "9916",
    "isPixOpenBanking": false
  },
  "entityId": "SC131400882025052972I0WCAUTOM",
  "companyKey": "AUTOMATED_TESTS_SDB",
  "idempotencyKey": "e10d0fda-5844-5df9-96f3-734115a301a3",
  "licenses": [
    {
      "id": "25bcb44c-992c-4cfa-98ef-d344c1ce838a",
      "provider": "ACESSO SOLUÇÕES DE PAGAMENTO S.A. - INSTITUIÇÃO DE PAGAMENTO",
      "types": [
        "Banking"
      ]
    }
  ],
  "licenseUuid": "25bcb44c-992c-4cfa-98ef-d344c1ce838a",
  "context": "Pix",
  "name": "PIX_AUTOMATIC_SCHEDULE_PAYMENT_WAS_FAILED",
  "version": "1",
  "timestamp": "2025-05-30T12:52:07.71",
  "correlationId": "6d6fa6f8-9145-4c75-a364-75c5381208ae"
}

{
  "data": {
    "reason": "TRANSFER_ORDER_NOT_PROCESSED",
    "recurrence": {
      "requestIdentifier": "RA131400882025080411112233445"
    },
    "schedule": {
      "endToEndId": "E131400882025080411112233445",
      "dateSchedule": "2025-08-04",
      "expirationDate": "2025-08-05",
      "status": "RESCHEDULED",
      "transactionIdentification": "b3492d8b-adde-413e-9b31-46ffce160f18",
      "purpose": "AGND",
      "finalAttempt": true,
      "amount": 1.99,
      "description": "Automation Test 3acd3ac6-962a-4441-9c74-ba29e2ce3f44",
      "creditor": {
        "name": "RECEBEDOR TESTE",
        "privateIdentification": "28173336407",
        "account": {
          "branch": "2020",
          "number": "502001605796",
          "participant": "01858774",
          "type": "CACC"
        }
      },
      "debtor": {
        "name": "PAGADOR TESTE",
        "privateIdentification": "52853664619",
        "account": {
          "branch": "0001",
          "number": "1104802861",
          "participant": "13140088",
          "type": "TRAN",
          "companyKey": "AUTOMATED_TESTS_SDB"
        }
      }
    },
    "name": "PIX_AUTOMATIC_SCHEDULE_PAYMENT_WAS_FAILED",
    "code": "9917",
    "isPixOpenBanking": false
  },
  "entityId": "SC131400882025052972I0WCAUTOM",
  "companyKey": "AUTOMATED_TESTS_SDB",
  "idempotencyKey": "e10d0fda-5844-5df9-96f3-734115a301a3",
  "licenses": [
    {
      "id": "25bcb44c-992c-4cfa-98ef-d344c1ce838a",
      "provider": "ACESSO SOLUÇÕES DE PAGAMENTO S.A. - INSTITUIÇÃO DE PAGAMENTO",
      "types": [
        "Banking"
      ]
    }
  ],
  "licenseUuid": "25bcb44c-992c-4cfa-98ef-d344c1ce838a",
  "context": "Pix",
  "name": "PIX_AUTOMATIC_SCHEDULE_PAYMENT_WAS_FAILED",
  "version": "1",
  "timestamp": "2025-05-30T12:52:07.71",
  "correlationId": "114f7f4a-bc0d-45f2-9646-f923ae58f7c3"
}

{
  "data": {
    "reason": "TRANSFER_ORDER_NOT_PROCESSED",
    "recurrence": {
      "requestIdentifier": "RA131400882025080411112233445"
    },
    "schedule": {
      "endToEndId": "E131400882025080411112233445",
      "dateSchedule": "2025-08-04",
      "expirationDate": "2025-08-05",
      "status": "ERROR",
      "transactionIdentification": "b3492d8b-adde-413e-9b31-46ffce160f18",
      "purpose": "AGND",
      "finalAttempt": true,
      "amount": 1.99,
      "description": "Automation Test dfbbba07-f482-4a65-bbb3-7c98aba4b4e2",
      "creditor": {
        "name": "RECEBEDOR TESTE",
        "privateIdentification": "28173336407",
        "account": {
          "branch": "2020",
          "number": "502001605796",
          "participant": "01858774",
          "type": "CACC"
        }
      },
      "debtor": {
        "name": "PAGADOR TESTE",
        "privateIdentification": "52853664619",
        "account": {
          "branch": "0001",
          "number": "1104802861",
          "participant": "13140088",
          "type": "TRAN",
          "companyKey": "AUTOMATED_TESTS_SDB"
        }
      }
    },
    "name": "PIX_AUTOMATIC_SCHEDULE_PAYMENT_WAS_FAILED",
    "code": "9918",
    "isPixOpenBanking": false
  },
  "entityId": "SC131400882025052972I0WCAUTOM",
  "companyKey": "AUTOMATED_TESTS_SDB",
  "idempotencyKey": "e10d0fda-5844-5df9-96f3-734115a301a3",
  "licenses": [
    {
      "id": "25bcb44c-992c-4cfa-98ef-d344c1ce838a",
      "provider": "ACESSO SOLUÇÕES DE PAGAMENTO S.A. - INSTITUIÇÃO DE PAGAMENTO",
      "types": [
        "Banking"
      ]
    }
  ],
  "licenseUuid": "25bcb44c-992c-4cfa-98ef-d344c1ce838a",
  "context": "Pix",
  "name": "PIX_AUTOMATIC_SCHEDULE_PAYMENT_WAS_FAILED",
  "version": "1",
  "timestamp": "2025-05-30T12:52:07.71",
  "correlationId": "1e1e454f-9b51-4e36-802c-4a5fbceb2ff1"
}

Códigos de cancelamento (Code)

O evento PIX_AUTOMATIC_SCHEDULE_PAYMENT_WAS_FAILED podem receber os seguintes códigos no campo code, referentes ao cancelamento:

Código	Descrição	O que esse erro quer dizer	Observação
1515	O valor do agendamento excedeu o valor máximo autorizado	—	Para essa notificação o `schedule.status` será: `ERROR`
1516	O valor do agendamento não corresponde ao valor autorizado	—	Para essa notificação o `schedule.status` será: `ERROR`
1531	`TRANSFER_ORDER_NOT_PROCESSED`	Erro na liquidação do agendamento de Pix automático após o envio da ordem de pagamento.	Conforme página de erros. Para essa notificação o `schedule.status` será: `ERROR`
9912	Os seguintes valores podem ser retornados para justificar a falha na liquidação: `SENDER_ACCOUNT_STATUS_NOT_ALLOW_CASH_OUT` `SENDER_ACCOUNT_NOT_FOUND` `SENDER_ACCOUNT_DOES_NOT_MATCH_THE_DOCUMENT` `CASHOUT_LIMIT_NOT_ENOUGH` `TRANSFER_WAS_REPROVED`	—	Conforme página de erros Para essa notificação o `schedule.status` será: `RESCHEDULED` ou `ERROR` (esse status só virá na retentativa de final do dia)
9914	`INSUFFICIENT_BALANCE`	A última tentativa foi realizada no período da manhã, mas não foi concluída por falta de saldo. Uma nova tentativa será efetuada à tarde.	Conforme página de erros Para essa notificação o `schedule.status` será: `RESCHEDULED`
9915	`INSUFFICIENT_BALANCE`	A última tentativa de pagamento já foi realizada e o pagamento não foi efetivado por falta de saldo.	Conforme página de erros Para essa notificação o `schedule.status` será: `ERROR`
9916	`TRANSFER_ORDER_NOT_PROCESSED`	Erro final no envio síncrono do pagamento.	Conforme página de erros Para essa notificação o `schedule.status` será: `ERROR`
9917	`TRANSFER_ORDER_NOT_PROCESSED`	A última tentativa foi realizada no período da manhã, mas não foi concluída por falha operacional. Uma nova tentativa será efetuada à tarde.	Conforme página de erros Para essa notificação o `schedule.status` será: `RESCHEDULED`
9918	`TRANSFER_ORDER_NOT_PROCESSED`	A última tentativa de pagamento já foi realizada e o pagamento não foi efetivado por falha operacional.	Conforme página de erros Para essa notificação o `schedule.status` será: `ERROR`

PIX_AUTOMATIC_PAYMENT_WAS_SCHEDULED

Descrição do objeto data do evento

Payload do evento

Código(s) de agendamento pix automático (Code)

PIX_AUTOMATIC_SCHEDULE_PAYMENT_WAS_CANCELED

Descrição do objeto data do evento

Payload do evento

Código(s) de agendamento pix automático (Code)

PIX_AUTOMATIC_SCHEDULE_PAYMENT_WAS_FAILED

Descrição do objeto data do evento

Payload do evento

Códigos de cancelamento (Code)

Fluxo de Notificações de Agendamento do Pix Automático