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	Descrição
`code`	`string`	Código da notificação. Nesse caso será o code 1528
`reason`	`string`	Motivo da notificação.
`isPixOpenBanking`	`boolean`	Transação iniciada por Open Finance.
`recurrence`	`object`	Objeto que contém os dados referentes à recorrência.
`recurrence.requestIdentifier`	`string`	Identificador único da recorrência.
`schedule`	`object`	Objeto que contem os dados do agendamento.
`schedule.endToEndId`	`string`	Identificador da Transação.
`schedule.dateSchedule`	`date`	Data de liquidação do agendamento.
`schedule.expirationDate`	`date`	Data de vencimento do agendamento.
`schedule.status`	`string`	Status do agendamento: `SCHEDULED` - Agendado
`schedule.transactionIdentification`	`string`	Identificador da transação (txid).
`schedule.purpose`	`string`	Tipo do agendamento: `AGND` - Primeiro agendamento `RIFL` - Retentativa de agendamento pós falha `NTAG` - Retentativa pós vencimento
`schedule.finalAttempt`	`boolean`	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`	`string`	Valor do agendamento.
`schedule.description`	`string`	Descrição do agendamento.
`schedule.creditor`	`object`	Objeto que contém os dados do recebedor do agendamento.
`schedule.creditor.name`	`string`	Nome do recebedor.
`schedule.creditor.privateIdentification`	`string`	CNPJ do cliente recebedor.
`schedule.creditor.account`	`object`	Objeto que contém os dados da conta do cliente recebedor.
`schedule.creditor.branch`	`string`	Número da agência do recebedor.
`schedule.creditor.number`	`string`	Número da conta do recebedor.
`schedule.creditor.participant`	`string`	ISPB do banco do cliente recebedor.
`schedule.creditor.type`	`string`	Tipo de conta do cliente recebedor. `CACC` - Conta corrente `SVGS` - Conta de Poupança. `TRAN` - Conta de Pagamento.
`schedule.debtor`	`object`	Objeto que contém os dados da conta do cliente pagador.
`schedule.debtor.name`	`string`	Nome do pagador.
`schedule.debtor.privateIdentification`	`string`	CPF ou CNPJ do cliente pagador.
`schedule.debtor.account`	object	Objeto que contém os dados da conta do cliente pagador.
`schedule.debtor.account.branch`	`string`	Número da agência do pagador.
`schedule.debtor.account.number`	`string`	Número da conta do pagador.
`schedule.debtor.account.participant`	`string`	ISPB do banco do cliente pagador.
`schedule.debtor.account.type`	`string`	Tipo de conta do cliente recebedor. `CACC` - Conta corrente `SVGS` - Conta de Poupança. `TRAN` - Conta de Pagamento.
`schedule.debtor.account.companyKey`	`string`	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": "1234567891011"
        }
      }
    }
  },
  "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	Descrição
`code`	`string`	Código da notificação. Nesse caso será o code 1530
`reason`	`string`	Motivo da notificação.
`recurrence`	`object`	Objeto que contém os dados referentes à recorrência.
`recurrence.requestIdentifier`	`string`	Identificador único da recorrência
`schedule`	`object`	Objeto que contem os dados do agendamento
`schedule.endToEndId`	`string`	Identificador da Transação
`schedule.dateSchedule`	`date`	Data de liquidação do agendamento.
`schedule.expirationDate`	`date`	Data de vencimento do agendamento.
`schedule.status`	`string`	Status do agendamento: `CANCELED` - Pagamento cancelado
`schedule.transactionIdentification`	`string`	Identificador da transação (txid)
`schedule.purpose`	`string`	Tipo do agendamento: `AGND` - Primeiro agendamento `RIFL` - Retentativa de agendamento pós falha `NTAG` - Retentativa pós vencimento
`schedule.finalAttempt`	`boolean`	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`	`string`	Valor do agendamento.
`schedule.description`	`string`	Descrição do agendamento.
`schedule.creditor`	`object`	Objeto que contém os dados do recebedor do agendamento.
`schedule.creditor.name`	`string`	Nome do recebedor.
`schedule.creditor.privateIdentification`	`string`	CNPJ do cliente recebedor.
`schedule.creditor.account`	`object`	Objeto que contém os dados da conta do cliente recebedor.
`schedule.creditor.branch`	`string`	Número da agência do recebedor.
`schedule.creditor.number`	`string`	Número da conta do recebedor.
`schedule.creditor.participant`	`string`	ISPB do banco do cliente recebedor.
`schedule.creditor.type`	`string`	Tipo de conta do cliente recebedor. `CACC` - Conta corrente `SVGS` - Conta de Poupança. `TRAN` - Conta de Pagamento.
`schedule.debtor`	`object`	Objeto que contém os dados da conta do cliente pagador.
`schedule.debtor.name`	`string`	Nome do pagador.
`schedule.debtor.privateIdentification`	`string`	CNPJ do cliente pagador.
`schedule.debtor.account`	`object`	Objeto que contém os dados da conta do cliente pagador.
`schedule.debtor.account.branch`	`string`	Número da agência do pagador.
`schedule.debtor.account.number`	`string`	Número da conta do pagador.
`schedule.debtor.account.participant`	`string`	ISPB do banco do cliente pagador.
`schedule.debtor.account.type`	`string`	Tipo de conta do cliente recebedor. `CACC` - Conta corrente `SVGS` - Conta de Poupança. `TRAN` - Conta de Pagamento.
`schedule.debtor.account.companyKey`	`string`	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": "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": "1234567891011"
        }
      }
    }
  },
  "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	Descrição
`code`	`string`	Código da notificação.
`reason`	`string`	Motivo da notificação.
`isPixOpenBanking`	`boolean`	Transação iniciada por Open Finance
`recurrence`	`object`	Objeto que contém os dados referentes à recorrência.
`recurrence.requestIdentifier`	`string`	Identificador único da recorrência
`schedule`	`object`	Objeto que contem os dados do agendamento
`schedule.endToEndId`	`string`	Identificador da Transação
`schedule.dateSchedule`	`date`	Data de liquidação do agendamento.
`schedule.expirationDate`	`date`	Data de vencimento do agendamento.
`schedule.status`	`string`	Status do agendamento: `RESCHEDULED`- Reagendado `ERROR` - Erro no pagamento
`schedule.transactionIdentification`	`string`	Identificador da transação (txid)
`schedule.purpose`	`string`	Tipo do agendamento: `AGND` - Primeiro agendamento `RIFL` - Retentativa de agendamento pós falha `NTAG` - Retentativa pós vencimento
`schedule.finalAttempt`	`boolean`	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`	`string`	Valor do agendamento.
`schedule.description`	`string`	Descrição do agendamento.
`schedule.paymentInitiator`	`string`	CNPJ do iniciador de pagamento
`schedule.creditor`	`object`	Objeto que contém os dados do recebedor do agendamento.
`schedule.creditor.name`	`string`	Nome do recebedor.
`schedule.creditor.privateIdentification`	`string`	CNPJ do cliente recebedor.
`schedule.creditor.account`	`object`	Objeto que contém os dados da conta do cliente recebedor.
`schedule.creditor.branch`	`string`	Número da agência do recebedor.
`schedule.creditor.number`	`string`	Número da conta do recebedor.
`schedule.creditor.participant`	`string`	ISPB do banco do cliente recebedor.
`schedule.creditor.type`	`string`	Tipo de conta do cliente recebedor. `CACC` - Conta corrente `SVGS` - Conta de Poupança. `TRAN` - Conta de Pagamento.
`schedule.debtor`	`object`	Objeto que contém os dados da conta do cliente pagador.
`schedule.debtor.name`	`string`	Nome do pagador.
`schedule.debtor.privateIdentification`	`string`	CNPJ do cliente pagador.
`schedule.debtor.account`	object	Objeto que contém os dados da conta do cliente pagador.
`schedule.debtor.account.branch`	`string`	Número da agência do pagador.
`schedule.debtor.account.number`	`string`	Número da conta do pagador.
`schedule.debtor.account.participant`	`string`	ISPB do banco do cliente pagador.
`schedule.debtor.account.type`	`string`	Tipo de conta do cliente recebedor. `CACC` - Conta corrente `SVGS` - Conta de Poupança. `TRAN` - Conta de Pagamento.
`schedule.debtor.account.companyKey`	`string`	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": "RIFL",
  		"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": "Checking"
  			}
  		},
  		"debtor": {
  			"name": "Joann Roberts",
  			"privateIdentification": "52853664619",
  			"account": {
  				"branch": "0001",
  				"number": "1104802861",
  				"participant": "13140088",
  				"type": "Payment",
  				"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": "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": "CACC",
  				"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"
}

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`
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