Agendamento

A etapa de agendamento de Pix Automático é o momento em que o PSP do recebedor envia ao PSP do Pagador uma transação para ser devidamente agendada na conta de um cliente que aderiu previamente ao serviço.
O recebedor deverá enviar a ordem de agendamento entre 10 e 2 dias úteis antes da data de liquidação para validação do PSP pagador.

No momento que recebe a ordem de agendamento, a Celcoin realizará todas as validações obrigatórias pertinentes a esta etapa da jornada do cliente pagador, sendo elas:

  1. Verificar se a conta do pagador está ativa e desbloqueada.
  2. Verificar se a solicitação de agendamento está respeitando o prazo mínimo de 2 dias úteis antes da execução.
  3. Verificar se a solicitação de agendamento está respeitando todos os parâmetros definidos pelo usuário pagador no momento do consentimento da autorização.

Exemplo: cliente pagador aderiu ao Pix Automático da sua conta de luz, mas definiu que o valor máximo para agendamento será de R$ 200,00.
Caso a a empresa envie uma solicitação de agendamento de R$ 200,01 ou acima, a Celcoin rejeitará a solicitação de agendamento, informando ao PSP recebedor que está fora do valor máximo definido pelo cliente pagador e também informará via webhook o cliente pagador que a solicitação de agendamento foi recusada.

Webhook de agendamento não realizado

evento: pix-automatic-scheduling


{
   "endToEndId":"endToEndId",
   "recurrencyId":"RR1234567820250516abcdefghi",
   "amount":10.00,
   "expirationDate":"2025-12-01T00:00:00Z",
   "type":"FIRST_ATTEMPT",
   "status":"CANCELLED",
   "creditParty":{
      "taxId":"12345678000199",
      "bank":"0000000",
      "name":"Academia Fitness Pro"
   },
   "debitParty":{
      "personType":"NATURAL_PERSON",
      "taxId":"98765432100",
      "bank":"0000000",
      "account":"98765-4",
      "branch":"0001",
      "stateCode":"00000"
   },
   "debtor":{
      "personType":"NATURAL_PERSON",
      "taxId":"98765432100",
      "name":"Carlos Eduardo Oliveira"
   },
   "cancellation":{
      "cancelledBy":"DEBIT",
      "personType":"NATURAL_PERSON",
      "taxId":"98765432100",
      "reason":"ACCOUNT_CANCELLATION",
      "date":"2025-05-16T15:30:00Z"
   },
   
   "createDate":"2025-05-16T15:30:00Z",
   "cancelledDate":"2025-05-16T15:30:00Z"
}

Se a solicitação de agendamento respeitar todas as condições necessárias, o agendamento será realizado.

Neste caso, a Celcoin responderá ao PSP recebedor que a solicitação de agendamento foi aceita com sucesso e automaticamente programará um débito na conta do pagador para a data de liquidação. Este evento enviará um webhook de sucesso para o cliente pagador ser notificado do aceite do agendamento.

Webhook de agendamento realizado

evento: pix-automatic-scheduling


{
   "endToEndId":"endToEndId",
   "recurrencyId":"RR1234567820250516abcdefghi",
   "amount":10.00,
   "expirationDate":"2025-12-01T00:00:00Z",
   "type":"FIRST_ATTEMPT",
   "status":"PAYMENT_SCHEDULED",
   "creditParty":{
      "taxId":"12345678000199",
      "bank":"0000000",
      "name":"Academia Fitness Pro"
   },
   "debitParty":{
      "personType":"NATURAL_PERSON",
      "taxId":"98765432100",
      "bank":"0000000",
      "account":"98765-4",
      "branch":"0001",
      "stateCode":"00000"
   },
   "debtor":{
      "personType":"NATURAL_PERSON",
      "taxId":"98765432100",
      "name":"Carlos Eduardo Oliveira"
   },
   "cancellation":null,
   "error":null,
   "createDate":"2025-05-16T15:30:00Z",
   "cancelledDate":null
}

Tabela de apoio
O motivo do cancelamento será trazido no campo "reason", abaixo os motivos:


❗️

Esta documentação ainda está sujeita a atualizações. Quando tivermos a versão final publicada, este aviso será removido de todas as páginas.