# Connecting your school to the registry service

> How to authorise EduPay to send old debts to protest — no key to paste, and only for schools in Brazil.

## What you will achieve

Linking the school to the service that takes old debts to protest at a Brazilian
registry office, and understanding what that link means.

After it, the **Delinquency 90+** screen appears in the menu, inside
**Contracts**, listing the instalments that crossed the deadline you configured.

## First of all: this only works in Brazil

Protest is an instrument of Brazilian law, carried out by Brazilian registry
offices. The service requires the debtor's CPF and the official code of the
municipality where they live — data that exists in Brazil and has no equivalent
elsewhere.

**If your school operates outside Brazil, this screen is not for you.** The
system does not block the connection today, so it is worth knowing: even
connected, submissions would be refused by the registry one by one, without the
screen explaining why clearly.

## You will not paste any key

This connection works differently from EduPay's others. **The school creates its
own account at the registry service** and, from inside EduPay, authorises the
system to act on its behalf.

That has two good practical consequences:

**You never type a password here.** No copying codes from one panel to another,
and no registry-service password stored inside EduPay.

**You can revoke the authorisation whenever you want**, from the service side,
without depending on us and without touching EduPay.

## Before you start

**An account at the registry service, in the institution's name.** It is the one
answering for the protests and paying the fees — it must be under the school's
tax ID.

**The institution's digital certificate.** A Brazilian ICP-Brasil e-CNPJ, either
A1 (a file installed on the computer) or A3 (a token or smart card). The
authorisation is **signed** with it, and there is no password-based alternative:
without a certificate, the connection cannot be completed.

**A computer — not a phone.** Phones and tablets cannot read digital
certificates. The connection has to be made on the machine where the A1
certificate is installed, or with the A3 token plugged in.

**Being the owner of the EduPay account.** Team members can see the screen, but
the connect button does not appear for them.

## Step by step

**1. Open `Integrations › Debt protest`.**

**2. Check the environment.** The **Environment** selector has two options. In
**Sandbox (testing)** nothing reaches a real registry — it is where you confirm
things work before they count. In **Production**, every submission is a real
protest, with cost and legal effect.

**3. Choose the title kind and click Save.** The **Default title kind** field has
two options, and the choice is not neutral:

- **CT — Contract** sends the signed enrolment contract as the document behind
  the debt. **It is not accepted by São Paulo notaries.**
- **DS — Service invoice** presents the debt as a service draft. The registry
  service may ask for that draft in its own panel, and the institution is the one
  answerable for issuing a draft without the matching invoice.

The notary is decided by the **student's municipality**, not the school's. A
school in any state with a student living in São Paulo needs the service invoice
kind to be able to protest that student.

The choice applies to the whole school. If yours has students both inside and
outside São Paulo, the panel flags row by row which ones fall outside the kind
you picked.

**4. Click Connect to Protesto24h.** EduPay takes you to the service's site.

**5. Install the certificate reader — first time only.** The first Protesto24h
screen warns that you need a digital certificate and must install their reader,
offering an **Iniciar instalação** button. There are two steps: adding the **Web
PKI** extension to the browser, and installing its companion program on the
computer. Done once per computer; on later connections the service skips
straight past it.

**6. Sign in with the digital certificate.** On the **Selecione seu certificado**
screen, pick the institution's certificate from the list and click **Entrar com
certificado digital**.

**7. Authorise EduPay.** The service shows what EduPay will be able to do on the
institution's behalf and asks you to confirm. Once done, you return to EduPay
already connected.

## How to know it worked

> [certo]
> The badge at the top reads **Connected**, the account's legal name and tax ID
> appear, along with the **Connected since** line and the date. The connect
> button gives way to **Test connection** and **Disconnect**.

A second sign, in the menu: **Delinquency 90+** now exists inside **Contracts**.

## Switching environments disconnects

The environment selector looks like an ordinary field, but it is not. **An
authorisation is valid only in the environment where it was granted** — a
testing authorisation does not work in production, and the other way round.

So saving the screen with the environment switched **disconnects the account**,
and the screen says so. That is not a failure: it is the only honest behaviour,
since the old authorisation stopped being usable.

The normal path is to connect in sandbox, confirm, and only then switch to
production and authorise again.

## If something goes wrong

> [erro]
> **The connect button looks dimmed and does not click.** The registry service
> is not available in this EduPay environment. It is not your school's problem —
> talk to support.
>
> **My certificate is not in the list.** Check three things, in this order: the
> Web PKI reader is installed (both the extension **and** the program); the A3
> token or card is plugged in; and the certificate has not expired. The
> Protesto24h screen itself has a **Clique aqui** link to refresh the list.
>
> **I am on a phone and cannot get past the certificate screen.** You will not
> get past it. Redo the connection on a computer holding the institution's
> certificate.
>
> **I came back from the service's site and the screen says it could not
> confirm.** Start again, in the same window and the same tab. Starting the
> connection at one address and returning at another makes EduPay not recognise
> the return.
>
> **Connected, but the delinquency panel is still empty.** The connection does
> not decide who enters the list. That comes from **Settings › Penalty and
> protest**: days overdue and minimum amount.
>
> **I cannot see the connect button.** Your account is a team account. Only
> whoever administers the EduPay account connects or disconnects services.


---

https://edupay.estudiosite.com/en/ajuda/day-to-day/connect-the-registry-service
2026-08-07
