跳到主要内容

银行代理人监控

1. 查询信贷代理人：​

请求​

ENDPOINT
/mcb/credit_agent/[CPF-DO-AGENTE]
MÉTODO
GET

查询参数​

枚举值描述
include_history在查询中返回代理人评分历史所需的参数

响应​

ENDPOINT
/mcb/credit_agent/[CPF-DO-AGENTE]
MÉTODO
GET
HTTP STATUS
200
响应体
{
    "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"
        }
    ]
}

响应体详情​

字段类型描述
document_numberstring信贷代理人的 CPF。
credit_agent_statusstring信贷代理人状态。
block_reasonstring信贷代理人被封锁的原因。
current_scorenumber代理人当前评分。
total_scorenumber代理人累积评分。
score_expiration_datestring代理人评分到期日期。
suspension_start_datestring代理人暂停开始日期。
suspension_end_datestring代理人暂停结束日期。
credit_agent_historylist代理人更新历史记录。
reference_datestring更新的参考日期。

credit_agent_status 枚举值​

枚举值描述
active代理人处于活跃状态
blocked代理人被封锁，无法发起操作

block_reason 枚举值​

枚举值描述
limit_score_reached达到了 Núclea 通报的评分上限。
expired_certificate因证书过期而被封锁。
rdr_identity_fraud因在 RDR 投诉系统中发现身份欺诈而被封锁。
fraud_report因在 MCB 中被两家以上金融机构举报欺诈而被封锁。
operation_irregularity因操作违规而被封锁。
other其他封锁原因。

2. 查询信贷代理人在 CRCP 的认证：​

请求​

ENDPOINT
/mcb/credit_agent/[CPF-DO-AGENTE]/certificate
MÉTODO
GET
STATUS
200
响应体
{
    "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
响应体
{
	"title": "Not Found",
	"description": "Credit agent not found.",
	"translation": "Agente de crédito não encontrado.",
	"code": "MCB000004"
}

响应体详情​

字段类型描述
document_numberstring信贷代理人的 CPF。
namestring认证代理人姓名。
certificate_listlist与信贷代理人关联的证书列表。
certifier_namestring认证机构名称。
certifier_codestring证书类型代码。
titlestring证书标题。
certificate_numberstring证书编号。
exam_datestring认证考试日期。
expiration_datestring证书到期日期。
certificate_statusstring查询时证书的状态。

certificate_status 枚举值​

枚举值描述
active证书处于有效状态
excluded证书已被认证机构注销