Cancelamento de Recorrência
Este fluxo é utilizado caso a empresa recebedora deseje cancelar o consentimento previamente realizado por um cliente pagador.
Neste cenário, o pagador havia autorizado o consentimento, mas por qualquer que seja o motivo, a empresa recebedora deseja cancelar aquela recorrência de Pix Automático.
Neste fluxo, a empresa recebedora enviará uma notificação ao cliente pagador cancelando o consentimento e após o retorno do PSP pagador a Celcoin enviará o webhook confirmando o cancelamento daquela jornada. Neste fluxo, não há um cenário onde o cliente pagador possa não concordar com o cancelamento da recorrência.
O cancelamento da recorrência cancelará todas as cobranças futuras associadas.
O cancelamento da recorrência pode ser efetuado através de duas fontes distintas:
- Pelo recebedor (o destinatário do pagamento)
- Pelo pagador (o originador do pagamento)
Cancelamento pelo recebedor
Endpoint POST /recurrencies/{id}/cancel
Request:
{
"cancellationPersonType": "LEGAL_PERSON",
"cancellationTaxId": "19297016000136",
"cancellationReason": "ACCOUNT_CANCELLATION"
}
Response
{
"version": "1.0.0",
"status": 200,
"body": {
"recurrencyId": "RC139358932025060749927585294",
"clientRequestId": "idasasdddas-dasdasdasd-dadadasdas-ddasdasdassd",
"interval": {
"start": "2025-06-07T09:45:00-03:00",
"end": null,
"frequencyType": "MONTHLY"
},
"status": "CANCELLATION_REQUEST",
"journeys": [
{
"status": "CANCELLATION_REQUEST",
"type": 2,
"createDate": "2025-06-07T09:45:00-03:00"
}
],
"amount": 100,
"creditParty": {
"bank": "13935893",
"branch": "10203040",
"account": "98765-4",
"taxId": "19297016000136",
"name": "Empresa Fictícia"
},
"debitParty": {
"bank": "10203040",
"personType": "NATURAL_PERSON",
"taxId": "00011122233",
"accountType": "CACC",
"branch": "10203040",
"account": "98765-4",
"stateCode": "3505708"
},
"debtor": {
"personType": "NATURAL_PERSON",
"taxId": "67167948080",
"name": "Pessoa Fictícia"
},
"contract": {
"number": "Contrato-12345",
"description": "Contrato de teste "
},
"allowsNewAttemptsAfterExpiration": true,
"recurrencyMaxAmount": null,
"createDate": "2025-06-07T09:45:00-03:00",
"allowAutoSendingPaymentInstructions": false,
"cancellation": {
"id": "IC139358932025060792624279100",
"cancelledBy": "CREDIT",
"taxId": 19297016000136,
"reason": "ACCOUNT_CANCELLATION",
"date": "2025-06-07T09:45:00-03:00"
}
}
}
Webhook de cancelamento de recorrência pelo recebedor
evento: pix-automatic-recurrency-completed
Repare que o campo "cancelledBy = CREDIT" mostra que é o recebedor
{
"body": {
"recurrencyId": "RR1393589320250820fqpb80CzMdC",
"clientRequestId": "e5ade67eabf6494f2dc063520a9d81bafdf7d979",
"interval": {
"start": "2025-09-19T00: 00: 00.0000000",
"end": null,
"frequencyType": "MONTHLY"
},
"status": "CANCELLED",
"journeys": [
{
"status": "ACCEPTED",
"type": 2,
"createDate": "2025-09-12T00: 00: 00.0000000"
}
],
"amount": null,
"creditParty": {
"bank": "13935893",
"branch": "0001",
"account": "000123456789",
"taxId": "12345678901",
"name": "Jo\u00e3o da Silva"
},
"debitparty": {
"bank": "10203040",
"personType": "NATURAL_PERSON",
"taxId": "00011122233",
"name": null,
"branch": "10203040",
"account": "98765-4",
"accountType": "CACC",
"stateCode": "3505708"
},
"debtor": {
"personType": "NATURAL_PERSON",
"taxId": "36057484061",
"name": "Jo\u00e3o da Silva"
},
"contract": {
"number": "102",
"description": "Assinatura carro"
},
"allowsNewAttemptsAfterExpiration": true,
"recurrencyMinAmount": null,
"recurrencyMaxAmount": null,
"createDate": "2025-09-12T00: 00: 00.0000000",
"updateDate": "2025-09-12T13: 07: 45.0842771",
"allowAutoSendingPaymentInstructions": true,
"cancellation": {
"id": "IC1393589320250607619029977197",
"cancelledBy": "CREDIT",
"taxId": "19297016000136",
"reason": "ACCOUNT_CANCELLATION",
"date": "2025-06-07"
}
},
"entity": "pix-automatic-recurrency-completed",
"createTimeStamp": "2025-09-12T13: 07: 45.0843698",
"status": "CANCELLED",
"webhookId": "4c8a48b4518a433a99c0446963ef75de"
}
Cancelamento pelo pagador
O webhook enviado ao recebedor quando a recorrência é cancelada pelo pagador é conforme abaixo:
Repare que o campo "cancelledBy = DEBIT" mostra que é o pagador
{
"body": {
"recurrencyId": "RR1393589320250820fqpb80CzMdC",
"clientRequestId": "e5ade67eabf6494f2dc063520a9d81bafdf7d979",
"interval": {
"start": "2025-09-19T00: 00: 00.0000000",
"end": null,
"frequencyType": "MONTHLY"
},
"status": "CANCELLED",
"journeys": [
{
"status": "ACCEPTED",
"type": 2,
"createDate": "2025-09-12T00: 00: 00.0000000"
}
],
"amount": null,
"creditParty": {
"bank": "13935893",
"branch": "0001",
"account": "000123456789",
"taxId": "12345678901",
"name": "Jo\u00e3o da Silva"
},
"debitparty": {
"bank": "10203040",
"personType": "NATURAL_PERSON",
"taxId": "00011122233",
"name": null,
"branch": "10203040",
"account": "98765-4",
"accountType": "CACC",
"stateCode": "3505708"
},
"debtor": {
"personType": "NATURAL_PERSON",
"taxId": "36057484061",
"name": "Jo\u00e3o da Silva"
},
"contract": {
"number": "102",
"description": "Assinatura carro"
},
"allowsNewAttemptsAfterExpiration": true,
"recurrencyMinAmount": null,
"recurrencyMaxAmount": null,
"createDate": "2025-09-12T00: 00: 00.0000000",
"updateDate": "2025-09-12T13: 07: 45.0842771",
"allowAutoSendingPaymentInstructions": true,
"cancellation": {
"id": "IC1393589320250607619029977197",
"cancelledBy": "DEBIT",
"taxId": "19297016000136",
"reason": "ACCOUNT_CANCELLATION",
"date": "2025-06-07"
}
},
"entity": "pix-automatic-recurrency-completed",
"createTimeStamp": "2025-09-12T13: 07: 45.0843698",
"status": "CANCELLED",
"webhookId": "4c8a48b4518a433a99c0446963ef75de"
}
Updated 11 days ago