Serasa CPF 分数与 Limpa Nome 接口

Serasa Experian · 信贷

Serasa: Consulta CPF e Score 是 Serasa Experian 面向巴西消费者的征信局应用，提供 CPF 查询、Serasa Score、Limpa Nome 欠款协商、信用监控、Pix 钱包与待缴账单、分数锁定/解锁，以及 Serasa Extract（LGPD 个人数据报告）。Android 首页展示分数卡、锁定开关、待清理欠款、信贷区报价、钱包/Pix 密钥、暗网告警与摘录申请。它与 Boa Vista SCPC、Quod 以及 Nubank、Itaú、Santander、Caixa 应用内的分数入口争夺同一批想看征信分、又不愿逐家催收电话结清逾期债的巴西用户。登录用 CPF 加密码或已保存的生物识别登录，可勾选记住登录。

征信分读数落在 score，并带 scoreVersion 与 model；锁定/解锁摘要把该数字包成 value，旁边是 isPremium 与 isLocked。Limpa Nome 卡片携带 offerId、discountPercentage 与 discountValue，对应 debtType；已成交协议以 agreementId 和 agreementStatus 出现。征信摘录列出带 contractNumber 与 occurrenceDate 的 negativatedDebts，档案上的 CPF 身份是 cpf、ppid 与 cellphone。钱包现金是 balance 的 total；Pix 密钥以 key / hasKeys 返回。监控侧给出 alertSend、被监控的 companies 条目与暗网状态 card；信贷区签发 redirectUrl，把已登录消费者交给合作方结账。催收台、信贷市场合作方与身份监控栈会消费这些字段 — openData Studio 把它们变成可调用的开放数据。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

签发生物识别登录令牌

POST /v1/consumer/auth/biometric-exchange osint

用 CPF 加已保存的 biometricToken（或 password）换取后续消费端调用所用的 token、sessionToken 与 utToken。

认证方式：无需令牌的 JSON 请求体。返回的 token、sessionToken 与 utToken 作为后续消费端调用的 Bearer 凭证。

cpf
isRemember
password
biometricToken
prefSe
prefSe2
event
requestToken
id
otp
token
utToken
validAt
sessionToken
persistentToken
name
email
cellphone
loa
status
type
needsReconfirm
tokenEligible
userData

POST /v1/consumer/auth/biometric-exchange HTTP/1.1
Content-Type: application/json

{
  "cpf": "12345678901",
  "isRemember": true,
  "password": null,
  "biometricToken": "<biometric-token>",
  "prefSe": "android",
  "prefSe2": "9.100.1",
  "event": "login",
  "requestToken": "<request-token>"
}

{
  "id": "usr-4412",
  "otp": false,
  "token": "<jwt>",
  "utToken": "ut_7c2a",
  "validAt": "2026-10-17T18:30:00Z",
  "sessionToken": "sess_aa11",
  "persistentToken": "pt_bb22",
  "cpf": "12345678901",
  "name": "Maria Silva",
  "email": "[email protected]",
  "cellphone": "11987654321",
  "loa": 2,
  "status": "ACTIVE",
  "type": "PF",
  "needsReconfirm": false,
  "tokenEligible": true,
  "userData": {
    "id": "usr-4412"
  }
}

读取已登录会话

GET /v1/consumer/identity/current osint

按当前令牌返回已登录身份（id、cpf、name、email、cellphone、birth_date）。

认证方式：来自登录交换的 Bearer 令牌。

id
email
cellphone
cpf
name
birth_date
accepted_terms
cellphone_verified_at

GET /v1/consumer/identity/current HTTP/1.1
Authorization: Bearer <access-token>

{
  "id": "usr-4412",
  "email": "[email protected]",
  "cellphone": "11987654321",
  "cpf": "12345678901",
  "name": "Maria Silva",
  "birth_date": "1990-03-12",
  "accepted_terms": "2026-01-15T12:00:00Z",
  "cellphone_verified_at": "2026-02-01T09:14:00Z"
}

读取消费者档案

GET /v1/consumer/identity/profile osint

登录后加载消费者档案：身份（id、ppid、cpf、name、email、cellphone），以及 loa、sessionId、ewallet 与待缴账单授权标记。

认证方式：来自登录交换的 Bearer 令牌。

id
ppid
cpf
name
firstName
initials
email
cellphone
birthDate
loa
sessionId
token
transactionId
billsToPayUserOptIn
billsToPayDdaAuthorizePartner
ewallet
picture
kba
subscription
settings

GET /v1/consumer/identity/profile HTTP/1.1
Authorization: Bearer <access-token>

{
  "id": "usr-4412",
  "ppid": "pp-10028441",
  "cpf": "12345678901",
  "name": "Maria Silva",
  "firstName": "Maria",
  "initials": "MS",
  "email": "[email protected]",
  "cellphone": "11987654321",
  "birthDate": "1990-03-12",
  "loa": 2,
  "sessionId": "sess_aa11",
  "token": "<jwt>",
  "transactionId": "txn-7c2a",
  "billsToPayUserOptIn": true,
  "billsToPayDdaAuthorizePartner": false,
  "ewallet": {
    "enabled": true
  }
}

分数锁定/解锁摘要

GET /v1/consumer/score/lock-status openfinance

返回分数锁定首页：带 status 标签的分数 value、isPremium、autoLockUnlock.isLocked 与 vipCard。

认证方式：来自登录交换的 Bearer 令牌。

title
isPremium
score
value
status
details
autoLockUnlock
isLocked
icon
description
processingIcon
processingDescription
faqResume
vipCard

GET /v1/consumer/score/lock-status HTTP/1.1
Authorization: Bearer <access-token>

{
  "title": "Serasa Score",
  "isPremium": false,
  "score": {
    "value": 734,
    "status": {
      "label": "GOOD"
    },
    "details": {
      "model": "serasa-score"
    }
  },
  "status": {
    "label": "UNLOCKED"
  },
  "autoLockUnlock": {
    "icon": "lock",
    "isLocked": false,
    "description": "Score visivel para o mercado",
    "processingIcon": "hourglass",
    "processingDescription": "Atualizando"
  },
  "faqResume": {
    "items": []
  },
  "vipCard": {
    "visible": false
  }
}

钱包摘要

GET /v1/consumer/wallet/summary openbanking

读取应用内钱包首页：balance.total 与已保存的 creditCards。

认证方式：来自登录交换的 Bearer 令牌。

balance
total
creditCards

GET /v1/consumer/wallet/summary HTTP/1.1
Authorization: Bearer <access-token>

{
  "balance": {
    "total": 128.45
  },
  "creditCards": {
    "items": [
      {
        "idCreditCard": "cc-4412",
        "brand": "mastercard"
      }
    ]
  }
}

列出 Pix 密钥
GET /v1/consumer/wallet/pix-keys openbanking
以 hasKeys 及每个密钥的 id 与 key 值列出已登记的 Pix 密钥。
认证方式：来自登录交换的 Bearer 令牌。
- hasKeys
- key
- id
```
GET /v1/consumer/wallet/pix-keys HTTP/1.1
Authorization: Bearer <access-token>
```
```
{
  "hasKeys": true,
  "key": {
    "id": "pix-7c2a",
    "key": "12345678901"
  }
}
```

Pix 入金流水

GET /v1/consumer/wallet/pix-ledger openbanking

以 transactionsByMonth 及当前 balance 返回 Pix 入金台账。

认证方式：来自登录交换的 Bearer 令牌。

transactionsByMonth
balance

GET /v1/consumer/wallet/pix-ledger HTTP/1.1
Authorization: Bearer <access-token>

{
  "balance": 128.45,
  "transactionsByMonth": [
    {
      "month": "2026-10",
      "items": [
        {
          "amount": 50.0,
          "type": "CASHIN"
        }
      ]
    }
  ]
}

列出 Limpa Nome 欠款报价

GET /v1/consumer/debt-offers openfinance

列出 Limpa Nome 报价行，含 offerId、contractHash 以及卡片的 discountPercentage、discountValue 与 debtType。

认证方式：来自登录交换的 Bearer 令牌。可选查询参数选择报价上下文。

message
status
data
offers
offerId
contractHash
card
tags
debtType
offerType
hasInstallments
discountPercentage
discountValue
isCart
isEligibleCart
recommended
footer
consolidationCard
cartDataOffersResponse
otherOffersResponse

GET /v1/consumer/debt-offers HTTP/1.1
Authorization: Bearer <access-token>

{
  "message": "OK",
  "status": 200,
  "data": {
    "offers": [
      {
        "offerId": "off-9c10",
        "contractHash": "ch_aa11",
        "card": {
          "tags": ["discount"],
          "debtType": "NEGATIVATED",
          "offerType": "INSTALLMENT",
          "hasInstallments": true,
          "discountPercentage": 40.0,
          "discountValue": 800.0,
          "isCart": false,
          "isEligibleCart": true
        }
      }
    ],
    "recommended": [],
    "footer": {},
    "consolidationCard": {},
    "cartDataOffersResponse": {},
    "otherOffersResponse": {}
  }
}

欠款报价详情

GET /v1/consumer/debt-offers/{offerId} openfinance

按 offerId 加载单个欠款报价：id、debtType、offerType、debtOrigin 以及债权方 companyInformation（partner、title）。

认证方式：来自登录交换的 Bearer 令牌。

message
status
data
id
header
debtType
offerType
debtOrigin
companyInformation
title
subtitle
debtDisclaimer
partner
details

GET /v1/consumer/debt-offers/off-9c10 HTTP/1.1
Authorization: Bearer <access-token>

{
  "message": "OK",
  "status": 200,
  "data": {
    "id": "off-9c10",
    "header": "Negocie com o credor",
    "debtType": "NEGATIVATED",
    "offerType": "INSTALLMENT",
    "debtOrigin": "SPC",
    "companyInformation": {
      "title": "Loja Exemplo",
      "subtitle": "CNPJ 00.000.000/0001-00",
      "debtDisclaimer": "Valores sujeitos a atualizacao",
      "partner": "lno",
      "details": []
    }
  }
}

列出欠款协议

GET /v1/consumer/debt-agreements openfinance

返回协议分组，含已成交 Limpa Nome 协议的 agreementId、cartId、consolidationId 与 agreementStatus。

认证方式：来自登录交换的 Bearer 令牌。

message
status
data
emptyState
agreementList
section
title
description
list
agreementId
cartId
consolidationId
image
agreementStatus

GET /v1/consumer/debt-agreements HTTP/1.1
Authorization: Bearer <access-token>

{
  "message": "OK",
  "status": 200,
  "data": {
    "emptyState": null,
    "agreementList": [
      {
        "section": "ACTIVE",
        "title": "Acordos vigentes",
        "description": "Parcelas em dia",
        "list": [
          {
            "agreementId": "agr-4412",
            "cartId": null,
            "consolidationId": null,
            "image": "https://cdn.example/partner.png",
            "description": "Loja Exemplo",
            "agreementStatus": "ACTIVE"
          }
        ]
      }
    ]
  }
}

Serasa Extract 报告

GET /v1/consumer/reports/personal-data openfinance

加载个人数据报告首页：userBlocked、subscriberBox 以及分节卡片。

认证方式：来自登录交换的 Bearer 令牌。

userBlocked
cards
subscriberBox
error
key
icon
title
description
observation

GET /v1/consumer/reports/personal-data HTTP/1.1
Authorization: Bearer <access-token>

{
  "userBlocked": false,
  "subscriberBox": {
    "visible": true
  },
  "cards": [
    {
      "error": false,
      "key": "debts",
      "icon": "alert",
      "title": "Dividas negativadas",
      "description": "2 ocorrencias",
      "observation": "Atualizado hoje"
    }
  ]
}

征信局文件摘要

GET /v1/consumer/reports/bureau-summary openfinance

返回征信摘要：authenticityCode，以及 negativatedDebts（companyName、contractNumber、occurrenceDate、value），另含 bankruptcies、badChecks、protests 与 lawSuits。

认证方式：来自登录交换的 Bearer 令牌。

subscription
authenticityCode
report
generationDate
negativatedDebts
bankruptcies
badChecks
protests
lawSuits
companyName
document
debts
availabilityDate
date
occurrenceDate
value
contractNumber
source

GET /v1/consumer/reports/bureau-summary HTTP/1.1
Authorization: Bearer <access-token>

{
  "subscription": {
    "active": true
  },
  "authenticityCode": "auth-7c2a",
  "report": {
    "generationDate": "2026-10-17T12:00:00Z",
    "negativatedDebts": {
      "items": [
        {
          "companyName": "Loja Exemplo",
          "document": "00000000000100",
          "debts": [
            {
              "availabilityDate": "2026-09-01",
              "date": "2026-08-15",
              "occurrenceDate": "2026-08-10",
              "value": 1999.9,
              "contractNumber": "CT-9981",
              "source": "SPC"
            }
          ]
        }
      ]
    },
    "bankruptcies": {"items": []},
    "badChecks": {"items": []},
    "protests": {"items": []},
    "lawSuits": {"items": []}
  }
}

暗网监控卡片

GET /v1/consumer/monitoring/breach-watch osint

加载高级暗网监控页：title、description、状态卡片（icon、title、description）与 info。

认证方式：来自登录交换的 Bearer 令牌。

title
description
card
icon
info

GET /v1/consumer/monitoring/breach-watch HTTP/1.1
Authorization: Bearer <access-token>

{
  "title": "Monitoramento Dark Web",
  "description": "Seus dados na dark web",
  "card": {
    "icon": "shield",
    "title": "Nenhum vazamento novo",
    "description": "Ultima varredura hoje"
  },
  "info": {
    "hint": "Adicione e-mail e celular"
  }
}

监控告警

GET /v1/consumer/monitoring/alert-settings osint

返回 CPF 监控告警设置：alertSend、info 与被监控的 companies。

认证方式：来自登录交换的 Bearer 令牌。

alertSend
info
companies

GET /v1/consumer/monitoring/alert-settings HTTP/1.1
Authorization: Bearer <access-token>

{
  "alertSend": {
    "enabled": true
  },
  "info": {
    "title": "Alertas do CPF"
  },
  "companies": {
    "items": [
      {
        "name": "Loja Exemplo",
        "document": "00000000000100"
      }
    ]
  }
}

信贷区跳转令牌
GET /v1/consumer/credit-offers/handoff openfinance
签发 redirectUrl，使信贷区市场把已登录消费者交给合作方结账。
认证方式：来自登录交换的 Bearer 令牌。查询参数携带信贷区订单标识。
- redirectUrl
```
GET /v1/consumer/credit-offers/handoff?orderId=ord-8f21 HTTP/1.1
Authorization: Bearer <access-token>
```
```
{
  "data": {
    "redirectUrl": "https://credito.example/checkout?tok=rt_9c10"
  }
}
```

数据类别

CPF 身份
会话令牌
信用分
分数锁定/解锁
Limpa Nome 报价
欠款协议
Pix 密钥
钱包余额
征信摘录
负面欠款
暗网监控
信贷市场

数据使用场景与案例

征信分锁定监控
贷款或催收台轮询 score 的 value、isPremium 与 autoLockUnlock.isLocked，在消费者把 Serasa Score 对市场锁定时暂停授信。
Limpa Nome 报价对账
欠款市场或 ERP 用 offerId、discountPercentage、discountValue、agreementId 与 agreementStatus 对照债权台账，使分期入账当天即可摘掉已结清的负面欠款。
Pix 钱包资金核对
支付运维读取 WalletResponse.balance.total、PixKeysResponse.key 与 PixExtractResponse.transactionsByMonth，把入金与 Limpa Nome 的 Pix 结账对齐。
CPF 泄露与抗议监控
身份风险栈把 MonitoringResponse.companies、DarkWebMonitoringResponse.card 与 SAFReportResponse.negativatedDebts、protests、contractNumber 拼在一起，新的征信命中或暗网卡片当天即可告警。

常见问题

Serasa 会话会返回哪些身份字段？

CPF 登录后，会话与档案载荷给出 id、ppid、cpf、name、email、cellphone、birthDate、loa 与 sessionId，以及后续调用使用的 token / sessionToken / utToken。

Limpa Nome 欠款报价上有什么？

每条 OffersResponse 有 offerId 与 contractHash；卡片携带 debtType、offerType、hasInstallments、discountPercentage、discountValue 以及购物车资格。详情补充 companyInformation.partner 与 debtOrigin。已成交协议出现在 agreementId 与 agreementStatus 下。

Serasa Score 的锁定如何表示？

锁定/解锁摘要返回 ScoreRuleResultResponse.value，以及 isPremium 与 AutoLockUnlock.isLocked。ScoreEntity 本身持有 score、scoreVersion、model、isScoreBureau 与 impact（primary / increases / decreases）。

征信摘录包含哪些分段？

Serasa Extract 卡片是分节（userBlocked、subscriberBox）。文件摘要补充 authenticityCode 以及 SAFReportResponse 桶：negativatedDebts、bankruptcies、badChecks、protests 与 lawSuits，每笔欠款带 contractNumber、occurrenceDate、value 与 source。

与 Serasa: Consulta CPF e Score 相似的应用

SPC Consumidor — SPC Consumidor 是 SPC Brasil 的官方应用，可免费查看 SPC Score，并确认 CPF 在 SPC Brasil 独立征信档案里是否有未结记录。
Acordo Certo — Acordo Certo 是 Consumidor Positivo（属 Equifax Boa Vista 集团）的欠款结清应用：可免费查 CPF、看哪些欠款在拉低分数，并在同一登录下与合作银行协商。
Consumidor Positivo — Equifax BoaVista 的 Consumidor Positivo 门户是 SCPC 征信局的消费端，可免费查询 CPF，分数会用到 Cadastro Positivo、欠款记录和用信时长。
Quod — Quod 是巴西征信局，其 Cadastro Positivo 档案会给出 300 到 1000 的 Quod Score；在消费者站点注册后可免费查看分数和登记信息。
Nubank — Nubank 的 NuScore（0–1000）按卡消费、储蓄习惯和负债程度给本行客户打分，结果不会改写 Serasa 等征信局分数。
Registrato — Registrato 是巴西央行按 CPF 汇总的报告，列出已开立银行账户、Pix 密钥和 SCR 欠款，只展示信贷关系、不出信用分。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

Serasa CPF 分数与 Limpa Nome 接口

应用截图

API 端点一览

签发生物识别登录令牌

读取已登录会话

读取消费者档案

分数锁定/解锁摘要

钱包摘要

列出 Pix 密钥

Pix 入金流水

列出 Limpa Nome 欠款报价

欠款报价详情

列出欠款协议

Serasa Extract 报告

征信局文件摘要

暗网监控卡片

监控告警

信贷区跳转令牌

数据类别

数据使用场景与案例

征信分锁定监控

Limpa Nome 报价对账

Pix 钱包资金核对

CPF 泄露与抗议监控

常见问题

与 Serasa: Consulta CPF e Score 相似的应用

更多信贷类应用

Brigit: Cash Advance & Credit

Cairin: Pinjaman Daring Cepat

CASHe: Quick Personal Loan App

Dave: Credit, Cash & Money App

相关主题

需要集成这个 App 的数据 API？

Serasa CPF 分数与 Limpa Nome 接口

应用截图

API 端点一览

签发生物识别登录令牌

读取已登录会话

读取消费者档案

分数锁定/解锁摘要

钱包摘要

列出 Pix 密钥

Pix 入金流水

列出 Limpa Nome 欠款报价

欠款报价详情

列出欠款协议

Serasa Extract 报告

征信局文件摘要

暗网监控卡片

监控告警

信贷区跳转令牌

数据类别

数据使用场景与案例

征信分锁定监控

Limpa Nome 报价对账

Pix 钱包资金核对

CPF 泄露与抗议监控

常见问题

相关应用

与 Serasa: Consulta CPF e Score 相似的应用

更多信贷类应用

Brigit: Cash Advance & Credit

Cairin: Pinjaman Daring Cepat

CASHe: Quick Personal Loan App

Dave: Credit, Cash & Money App

相关主题

需要集成这个 App 的数据 API？