Monitoramento do correspondente bancário

1. Consultar Agente de crédito:

Request

ENDPOINT

/mcb/credit_agent/[CPF-DO-AGENTE]

MÉTODO

GET

QUERY PARAMETERS

Enumerador	Descrição
include_history	Parâmetro necessário para retornar o histórico de pontuação do agente na consulta

Response

ENDPOINT

/mcb/credit_agent/[CPF-DO-AGENTE]

MÉTODO

GET

HTTP STATUS

200

Response Body

{
    "document_number": "02353050069",
    "credit_agent_status": "blocked",
    "block_reason": "limit_score_reached",
    "credit_agent_history": [
        {
            "credit_agent_status": "active",
            "block_reason": null,
            "current_score": 0,
            "total_score": 0,
            "score_expiration_date": null,
            "suspension_start_date": null,
            "suspension_end_date": null,
            "reference_date": "2025-06-26"
        },
        {
            "credit_agent_status": "blocked",
            "block_reason": "limit_score_reached",
            "current_score": 22,
            "total_score": 22,
            "score_expiration_date": null,
            "suspension_start_date": "2025-08-26",
            "suspension_end_date": null,
            "reference_date": "2025-08-26"
        }
    ]
}

Response body details

Campo	Tipo	Descrição
document_number	string	CPF do agente de crédito.
credit_agent_status	string	Status do agente de crédito.
block_reason	string	Motivo de bloqueio do agente de crédito.
current_score	number	Pontuação atual do agente.
total_score	number	Pontuação acumulada do agente.
score_expiration_date	string	Data de expiração da pontuação do agente.
suspension_start_date	string	Data de início da suspensão do agente.
suspension_end_date	string	Data de fim da suspensão do agente.
credit_agent_history	list	Histórico de atualizações do agente.
reference_date	string	Data de referencia da atualização.

Enumeradores credit_agent_status

Enumerador	Descrição
active	Agente está ativo
blocked	Agente está bloqueado para originar operação

Enumeradores block_reason

Enumerador	Descrição
limit_score_reached	Limite de pontuação atingido informado pela núclea.
expired_certificate	Bloqueio devido a certificação expirada.
rdr_identity_fraud	Bloqueio devido a fraude de identidade identificada no sistema de reclamações RDR.
fraud_report	Bloqueio por receber denúncia de fraude por mais de 2 instituições financeiras no MCB.
operation_irregularity	Bloqueio devido a irregularidade de operação
other	Outros motivos de bloqueio

2. Consultar certificação do agente de crédito no CRCP:

Request

ENDPOINT

/mcb/credit_agent/[CPF-DO-AGENTE]/certificate

MÉTODO

GET

STATUS

200

Response Body

{
    "document_number": "12345678911",
    "name": "NOME DO AGENTE DE CREDITO",
    "certificate_list": [
        {
            "certifier_name": "FEBRABAN",
            "certifier_code": "6345",
            "title": "LGPD para Correspondentes no Pais Res 4 935",
            "certificate_number": "1234567891234567",
            "exam_date": "11/01/2022",
            "expiration_date": "11/01/2024",
            "certificate_status": "excluded"
        },
        {
            "certifier_name": "FEBRABAN",
            "certifier_code": "6339",
            "title": "PLDFT em Conta Corrente Poupanca para Correspondente",
            "certificate_number": "1234567891234567",
            "exam_date": "28/12/2023",
            "expiration_date": "28/12/2025",
            "certificate_status": "active"
        },
    ]
}

STATUS

404

Response Body

{
	"title": "Not Found",
	"description": "Credit agent not found.",
	"translation": "Agente de crédito não encontrado.",
	"code": "MCB000004"
}

Response body details

Campo	Tipo	Descrição
document_number	string	CPF do agente de crédito.
name	string	Nome do agente certificado.
certificate_list	list	Lista de certificados vinculados ao agente de credito.
certifier_name	string	Nome da empresa certificadora.
certifier_code	string	Código do tipo do certificado .
title	string	Titulo do certificado.
certificate_number	string	Número do certificado.
exam_date	string	Data do exame da certificação.
expiration_date	string	Data de expiração do certificado.
certificate_status	string	Status do certificado na data da consulta.

Enumeradores certificate_status

Enumerador	Descrição
active	Certificado está ativo
excluded	Certificado foi excluido pela certificadora