Webhooks

Webhooks are used to send real-time notifications about events related to Automatic Pix transactions. Below, we detail the different webhook methods available, including payload examples and descriptions of their fields.

ConfirmPixAutomatic

This webhook is sent when an Automatic Pix confirmation is requested, typically in Journey 1 or 4, so that the Business Unit (BU) can notify the end user and obtain authorization.

{
    "Method": "ConfirmPixAutomatic",
    "PartnerId": 657,
    "BusinessUnitId": 11665,
    "RecurrenceId": "RR20250715703179819P6TN2OUFW8",
    "Description": "internet banda larga ventos novos",
    "Payer": {
        "Name": "Etevaldo MT",
        "TaxNumber": "98905764061",
        "BankCode": "450",
        "BankISPB": "13203354",
        "BankBranch": "0001",
        "BankAccount": "408505",
        "BankAccountDigit": "5",
        "ZipCode": "2304103"
    },
    "Retry": true,
    "Values": {
        "FinalValue": "string",
        "MaximumValue": "string"
    },
    "Contract": {
        "Identifier": "string",
        "Description": "string"
    },
    "Date": {
        "Frequency": 0,
        "InitialDate": "2025-07-29",
        "EndDate": "2025-07-29"
    },
    "Receiver": {
        "TaxNumber": "84928589076",
        "Name": "string"
    },
    "Timestamp": "2025-07-15T11:13:09.2348675-03:00"
}

Field	Description	Type	Mandatory
Method	Method or action of the webhook	String	Yes
PartnerId	Partner identifier	Integer	Yes
BusinessUnitId	Business unit identifier	Integer	Yes
RecurrenceId	Recurrence identifier	String	Yes
Description	Description of the transaction or service	String	Yes
Payer	Object containing payer information	Object	Yes
Payer.Name	Payer's name	String	Yes
Payer.TaxNumber	Payer's CPF/CNPJ	String	Yes
Payer.BankCode	Payer's bank code	String	Yes
Payer.BankISPB	Payer's bank ISPB code	String	Yes
Payer.BankBranch	Payer's bank branch code	String	Yes
Payer.BankAccount	Payer's bank account number	String	Yes
Payer.BankAccountDigit	Payer's bank account digit	String	Yes
Payer.ZipCode	Payer's postal code or city	String	Yes
Timestamp	Event date and time	String	Yes

NotifySchedule

This webhook notifies when a scheduling is created by the receiver.

{
    "Method": "NotifySchedule",
    "PartnerId": 657,
    "BusinessUnitId": 11665,
    "RecurrenceId": "RR20250715703179819P6TN2OUFW8",
    "Description": "Pix Automático agendado",
    "Details": {
        "ReceiverName": "COMPUTADORES OCSIS S/A",
        "Value": "100.00",
        "PaymentDate": "2025-07-15",
    },
}

Field	Description	Type	Mandatory
Method	Method or action of the webhook	String	Yes
BusinessUnitId	Business unit identifier	Integer	Yes
RecurrenceId	Recurrence identifier	String	Yes
Description	Event description	String	Yes
Details	Object with additional details	Object	Yes
Details.ReceiverName	Receiver's name	String	Yes
Details.Value	Transaction value	String	Yes
PaymentDate	Payment date of the scheduling	String	Yes

NotifyRecurrenceCanceled

This webhook notifies when a recurrence has been canceled by the receiver.

{
    "Method": "NotifyRecurrenceCanceled",
    "BusinessUnitId": 11665,
    "RecurrenceId": "RR2025071517611176B7XLH0W3KBC",
    "Description": "Recorrência cancelada pelo recebedor",
    "Details": {
        "ReceiverName": "COMPUTADORES OCSIS S/A",
        "Description": "internet banda larga ventos novos",
        "PendingPayments": "NaiBsj5eCLFhMYcN3FBim6KgoTi2ASj4Tw8",
        "Guidance": "Recorrência cancelada pelo recebedor. Novos agendamentos estarão suspensos"
    },
    "Timestamp": "2025-07-15T11:05:16.939366-03:00"
}

Field	Description	Type	Mandatory
Method	Method or action of the webhook	String	Yes
BusinessUnitId	Business unit identifier	Integer	Yes
RecurrenceId	Recurrence identifier	String	Yes
Description	Event description	String	Yes
Details	Object with additional details	Object	Yes
Details.ReceiverName	Receiver's name	String	Yes
Details.Description	Description of the service or transaction	String	Yes
Details.PendingPayments	Identifier for pending payments	String	Yes
Details.Guidance	Guidance for the user	String	Yes
Timestamp	Event date and time	String	Yes

NotifyScheduleCanceled

This webhook notifies when a scheduling is canceled.

{
    "Method": "NotifyScheduleCanceled",
    "BusinessUnitId": 11665,
    "RecurrenceId": "RR20250715703179819P6TN2OUFW8",
    "Description": "Agendamento cancelada",
    "Details": {
        "ReceiverName": "COMPUTADORES OCSIS S/A",
        "Description": "Conta",
        "ScheduledId": "12321252341134",
        "Reason": "Cancelamento solicitado pelo usuário recebedor"
    }
}

Field	Description	Type	Mandatory
Method	Method or action of the webhook	String	Yes
BusinessUnitId	Business unit identifier	Integer	Yes
RecurrenceId	Recurrence identifier	String	Yes
Description	Event description	String	Yes
Details	Object with additional details	Object	Yes
Details.ReceiverName	Receiver's name	String	Yes
Details.Description	Description of the service or transaction	String	Yes
Details.ScheduledId	Payment date of the scheduling	String	Yes
Details.Reason	Reason for the scheduling cancellation	String	Yes

NotifyLimit

This webhook is sent when the transaction value exceeds the configured per-transaction limit.

{
    "Method": "NotifyLimit",
    "BusinessUnitId": 11665,
    "RecurrenceId": "RR2025071594938451H2W9YMSRQG6",
    "Description": "Valor da transação de Pagamento Pix excede o Limite por transação para essa operação",
    "Details": {
        "ReceiverName": "COMPUTADORES OCSIS S/A",
        "Value": 1001.00,
        "Guidance": "Por favor, tente novamente mais tarde ou entre em contato com o recebedor"
    },
    "Timestamp": "2025-07-15T10:57:01.0223579-03:00"
}

Field	Description	Type	Mandatory
Method	Method or action of the webhook	String	Yes
BusinessUnitId	Business unit identifier	Integer	Yes
RecurrenceId	Recurrence identifier	String	Yes
Description	Event description	String	Yes
Details	Object with additional details	Object	Yes
Details.ReceiverName	Receiver's name	String	Yes
Details.Value	Transaction value that exceeded the limit	Number	Yes
Details.Guidance	Guidance for the user	String	Yes
Timestamp	Event date and time	String	Yes

NotifyValueExceed

This webhook is sent when the payment value exceeds the allowed limit for the operation.

{
    "Method": "NotifyValueExceed",
    "BusinessUnitId": 11665,
    "RecurrenceId": "RR20250715803986008I2Y4LB9S9O",
    "Description": "Valor do pagamento excede o limite permitido",
    "Details": {
        "ReceiverName": "COMPUTADORES OCSIS S/A",
        "Value": 1001.00,
        "Guidance": "Por favor, entre em contato com o recebedor para ajustar o valor"
    },
    "Timestamp": "2025-07-15T10:34:09.8100998-03:00"
}

Field	Description	Type	Mandatory
Method	Method or action of the webhook	String	Yes
BusinessUnitId	Business unit identifier	Integer	Yes
RecurrenceId	Recurrence identifier	String	Yes
Description	Event description	String	Yes
Details	Object with additional details	Object	Yes
Details.ReceiverName	Receiver's name	String	Yes
Details.Value	Transaction value that exceeded the limit	Number	Yes
Details.Guidance	Guidance for the user	String	Yes
Timestamp	Event date and time	String	Yes

NotifyOperationalFailure

This webhook notifies operational failures in payment processing.

{
    "Method": "NotifyOperationalFailure",
    "BusinessUnitId": 11665,
    "RecurrenceId": "RR202507106706383424EJPKFTZ66",
    "Description": "Falha operacional no pagamento",
    "Details": {
        "ReceiverName": "COMPUTADORES OCSIS S/A",
        "Value": 0.01,
        "Guidance": "Por favor, tente novamente mais tarde ou entre em contato com o recebedor"
    },
    "Timestamp": "2025-07-11T09:15:31.7035239-03:00"
}

Field	Description	Type	Mandatory
Method	Method or action of the webhook	String	Yes
BusinessUnitId	Business unit identifier	Integer	Yes
RecurrenceId	Recurrence identifier	String	Yes
Description	Event description	String	Yes
Details	Object with additional details	Object	Yes
Details.ReceiverName	Receiver's name	String	Yes
Details.Value	Value of the affected transaction	Number	Yes
Details.Guidance	Guidance for the user	String	Yes
Timestamp	Event date and time (ISO 8601 format)	String	Yes

NotifySuccess

This webhook notifies that the recurrence has been approved.

{
    "Method": "NotifySuccess",
    "BusinessUnitId": 11665,
    "RecurrenceId": "RR20250715703179819P6TN2OUFW8",
    "Description": "Confirmação Pix Automático",
    "Details": {
      "ReceiverName": "COMPUTADORES OCSIS S/A"
    },
    "Timestamp": "2025-07-15T11:13:09.2348675-03:00"
  }

Field	Description	Type	Mandatory
Method	Method or action of the webhook	String	Yes
BusinessUnitId	Business unit identifier	Integer	Yes
RecurrenceId	Recurrence identifier	String	Yes
Description	Event description	String	Yes
Details	Object with additional details	Object	Yes
Details.ReceiverName	Receiver's name	String	Yes
Timestamp	Event date and time (ISO 8601 format)	String	Yes

NotifyFailure

This webhook notifies that the recurrence has been rejected.

{
    "Method": "NotifyFailure",
    "BusinessUnitId": 11665,
    "RecurrenceId": "RR20250715703179819P6TN2OUFW8",
    "Description": "Confirmação Pix Automático - Falha",
    "Details": {
      "ReceiverName": "COMPUTADORES OCSIS S/A",
      "Guidance": "Falha ao confirmar Pix Automático"
    },
    "Timestamp": "2025-07-15T11:13:09.2348675-03:00"
  }

Field	Description	Type	Mandatory
Method	Method or action of the webhook	String	Yes
BusinessUnitId	Business unit identifier	Integer	Yes
RecurrenceId	Recurrence identifier	String	Yes
Description	Event description	String	Yes
Details	Object with additional details	Object	Yes
Details.ReceiverName	Receiver's name	String	Yes
Details.Guidance	Guidance for the user	String	Yes
Timestamp	Event date and time (ISO 8601 format)	String	Yes

ExpiredPixAutomatic

This webhook notifies that the recurrence has expired.

{
    "Method": "ExpiredPixAutomatic",
    "PartnerId": 657,
    "BusinessUnitId": 11665,
    "RecurrenceId": "RR20250715703179819P6TN2OUFW8",
    "ExpirationDate": "2025-08-29",
    "Status": "Expired",
    "Contract": {
      "Identifier": "string",
      "Description": "internet banda larga ventos novos",
      "Debtor": {
        "Name": "Etevaldo MT",
        "TaxNumber": "98905764061"
      },
      "Timestamp": "2025-07-15T11:13:09.2348675-03:00"
    }
  }

Field	Description	Type	Mandatory
Method	Method or action of the webhook	String	Yes
BusinessUnitId	Business unit identifier	Integer	Yes
RecurrenceId	Recurrence identifier	String	Yes
ExpirationDate	Expiration date of the recurrence	String	Yes
Status	Status of the recurrence	String	Yes
Contract	Object with contract details	Object	Yes
Contract.Identifier	Contract identifier	String	Yes
Contract.Description	Contract description	String	Yes
Contract.Debtor	Object with debtor details	Object	Yes
Contract.Debtor.Name	Debtor's name	String	Yes
Contract.Debtor.TaxNumber	Debtor's tax number	String	Yes
Contract.Timestamp	Event date and time (ISO 8601 format)	String	Yes