meutudo 数据 API：额度、贷款与合同

meutudo · 信贷

meutudo 是由 meutudo 推出的巴西工资及福利代扣贷款应用，将四类信贷产品集中在一起：面向私营部门雇员的 CLT 代扣贷款、面向退休人员和养老金领取者的 INSS 代扣贷款、FGTS 生日提款额度预支，以及附带 PIX 额度的代扣信用卡。用户可依据可扣款额度进行贷款试算，比较分期还款额和利率，拍摄上传 RG/CNH 证件并通过 FaceTec 自拍完成活体核验，再用短信验证码电子签署 CCB 信贷合同，随后在应用内跟进合同、缴款单和生成的 PDF。该应用仅在巴西运营，与其他代扣贷款机构和银行业务代理商争取同一批 INSS 与 CLT 客户的可扣款额度。

INSS 福利记录将 nb 与 nit 标识同 enrollmentName、margin 和 marginCode 一起列出。可扣款额度明细进一步区分 availableMargin、usedMargin、reservedMargin、freeMargin 与 marginFuture，为代扣贷款经纪和信贷风险团队提供额度监测所需的各项数值。贷款试算通过 enrollment 选择福利，并返回 installmentValue、installments、monthlyInterest、annualNominalRate、cetYearlyRate 和 totalAmount，用于比较报价。

合同准备阶段以 proposalId 引用已接受的贷款方案。合同记录包含 contractNumber、contractStatus（RUNNING、PENDING、PENDENCY、DONE、CANCELLED）、dueDate、firstPaymentDate，以及放款账户 bankAccount 及其 bankCode、agencyNumber、accountNumber 和 accountDigit。合同的分期计划与总额可同试算结果核对，缴款单记录则提供 installmentNumber 和 installmentAmount，用于还款对账。证件核验和 FaceTec 活体核验会话均使用 personDocument；证件正反面字段、documentType 与 documentStatus 描述证件核验环节，sessionToken 则用于活体核验环节。催收团队及开放金融聚合服务商可围绕这些记录搭建合同跟踪、开户衔接与还款工具；openData Studio 将这些数据转化为可调用的开放数据。

应用截图

API 端点一览

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

CPF 注册状态查询
POST /illustrative/v1/payroll-credit/registration-status openbanking
在密码或短信登录前，判断指定 CPF 是否已注册 meutudo 账户，以及该账户已加入哪些业务协议（INSS、FGTS），据此引导后续注册流程。
认证方式：无需认证。网关上的公开注册入口；客户端发送 personDocument 以及平台和设备请求头。
- personDocument
- platform
- registered
- personId
- registrationStatus
- agreements
```
POST /illustrative/v1/payroll-credit/registration-status HTTP/1.1
Content-Type: application/json

{
  "personDocument": "12345678909",
  "platform": "APP"
}
```
```
{
  "registered": true,
  "personId": "per_88213",
  "registrationStatus": "IN_PROGRESS",
  "agreements": [
    "inss",
    "fgts"
  ]
}
```
密码登录
POST /illustrative/v1/payroll-credit/member-session openbanking
供已注册 CPF 使用密码登录，并签发绑定该客户的 Bearer 令牌，供合同、可扣款额度和证件调用使用。
认证方式：无需预先认证。通过凭据交换返回 access_token，应用后续以 Bearer 前缀携带该令牌。
- personDocument
- password
- deviceId
- platform
- access_token
- expiresAt
- personId
- personName
```
POST /illustrative/v1/payroll-credit/member-session HTTP/1.1
Content-Type: application/json

{
  "personDocument": "12345678909",
  "password": "<PASSWORD>",
  "deviceId": "<device-id>",
  "platform": "APP"
}
```
```
{
  "access_token": "<ACCESS_TOKEN>",
  "expiresAt": "2026-10-25T18:00:00Z",
  "personId": "per_88213",
  "personName": "Maria Silva"
}
```
短信验证码验证
POST /illustrative/v1/payroll-credit/sms-confirmation openbanking
验证在注册、首次使用、密码重置或合同电子签署过程中发送至客户手机的短信验证码。
认证方式：无需预先认证，以短信验证码作为凭据；该调用也用于密码找回和首次使用。
- personDocument
- smsToken
- deviceId
- access_token
- expiresAt
- registrationStatus
- termsAccepted
```
POST /illustrative/v1/payroll-credit/sms-confirmation HTTP/1.1
Content-Type: application/json

{
  "personDocument": "12345678909",
  "smsToken": "<SMS_CODE>",
  "deviceId": "<device-id>"
}
```
```
{
  "access_token": "<ACCESS_TOKEN>",
  "expiresAt": "2026-10-25T18:00:00Z",
  "registrationStatus": "IN_PROGRESS",
  "termsAccepted": false
}
```
按邮政编码查询地址
GET /illustrative/v1/payroll-credit/postal-address openbanking
依据客户的 CEP 邮政编码，自动补全注册与住址证明步骤中的居住地址。
认证方式：使用登录取得的 Bearer access_token。
- zipcode
- zipCode
- street
- neighborhood
- city
- state
- complement
```
GET /illustrative/v1/payroll-credit/postal-address?zipcode=01310100 HTTP/1.1
Authorization: Bearer <ACCESS_TOKEN>
```
```
{
  "zipCode": "01310-100",
  "street": "Avenida Paulista",
  "neighborhood": "Bela Vista",
  "city": "São Paulo",
  "state": "SP",
  "complement": null
}
```
贷款资格预检查
POST /illustrative/v1/payroll-credit/eligibility-check openbanking
在进入试算界面前，检查客户是否有可用的扣款额度，以及是否存在阻止新增代扣贷款的待办事项。
认证方式：使用登录取得的 Bearer access_token。
- personDocument
- product
- amount
- canSimulate
- marginCode
- blockedReason
- hasPendencies
```
POST /illustrative/v1/payroll-credit/eligibility-check HTTP/1.1
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json

{
  "personDocument": "12345678909",
  "product": "INSS_CONSIGNADO",
  "amount": 5000
}
```
```
{
  "canSimulate": true,
  "marginCode": "MARGIN_OK",
  "blockedReason": null,
  "hasPendencies": false
}
```
INSS 福利列表
GET /illustrative/v1/payroll-credit/benefit-enrollments openbanking
列出关联到客户的 INSS 福利及其 NB/NIT 标识，以便针对指定的退休金、养老金或补助进行贷款试算。
认证方式：使用 Bearer access_token；根据令牌确定客户身份。
- benefits
- nb
- nit
- enrollmentName
- margin
- marginCode
```
GET /illustrative/v1/payroll-credit/benefit-enrollments HTTP/1.1
Authorization: Bearer <ACCESS_TOKEN>
```
```
{
  "benefits": [
    {
      "nb": "1234567890",
      "nit": "12345678901",
      "enrollmentName": "APOSENTADORIA POR IDADE",
      "margin": 1240.5,
      "marginCode": "MARGIN_OK"
    }
  ]
}
```
INSS 可扣款额度明细
GET /illustrative/v1/payroll-credit/deduction-capacity openbanking
返回一项 INSS 福利的可扣款额度明细，该额度上限用于确定贷款规模并解释拒绝代码。
认证方式：使用 Bearer access_token。
- availableMargin
- usedMargin
- reservedMargin
- freeMargin
- marginFuture
- marginCode
```
GET /illustrative/v1/payroll-credit/deduction-capacity?enrollment=1234567890 HTTP/1.1
Authorization: Bearer <ACCESS_TOKEN>
```
```
{
  "availableMargin": 1240.5,
  "usedMargin": 310.0,
  "reservedMargin": 0,
  "freeMargin": 930.5,
  "marginFuture": 155.2,
  "marginCode": "MARGIN_OK"
}
```

贷款试算

POST /illustrative/v1/payroll-credit/repayment-estimate openbanking

依据客户的可扣款额度计算代扣贷款报价，返回分期还款额、利息和 CET 综合融资成本数据，供试算与比较界面使用。

认证方式：使用 Bearer access_token。

product
amount
installments
enrollment
proposalValue
installmentValue
monthlyInterest
annualInterest
annualNominalRate
cetYearlyRate
cetMontlhyRate
totalAmount
firstPaymentDate

POST /illustrative/v1/payroll-credit/repayment-estimate HTTP/1.1
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json

{
  "product": "INSS_CONSIGNADO",
  "amount": 5000,
  "installments": 84,
  "enrollment": "1234567890"
}

{
  "proposalValue": 5000,
  "installmentValue": 92.4,
  "installments": 84,
  "monthlyInterest": 1.79,
  "annualInterest": 23.7,
  "annualNominalRate": 23.7,
  "cetYearlyRate": 28.4,
  "cetMontlhyRate": 2.1,
  "totalAmount": 7761.6,
  "firstPaymentDate": "2026-11-10"
}

INSS 试算（PIX 代扣／未来额度）

POST /illustrative/v1/payroll-credit/special-inss-estimate openbanking

执行新版 INSS 试算，包括 PIX 代扣与未来额度两种方案，并返回可供客户接受的贷款方案。

认证方式：使用 Bearer access_token。

type
enrollment
amount
installments
proposalId
proposalValue
installmentValue
firstPaymentDate

POST /illustrative/v1/payroll-credit/special-inss-estimate?type=CONSIGNED_PIX HTTP/1.1
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json

{
  "enrollment": "1234567890",
  "amount": 3000,
  "installments": 60
}

{
  "proposalId": "prop_99120",
  "proposalValue": 3000,
  "installmentValue": 61.5,
  "installments": 60,
  "firstPaymentDate": "2026-11-10"
}

合同准备

POST /illustrative/v1/payroll-credit/contract-preparation openbanking

将已接受的贷款方案转为合同记录，并在提交证件和签署前确定放款银行账户。

认证方式：使用 Bearer access_token。

proposalId
personDocument
installmentNumber
bankAccount
bankCode
agencyNumber
accountNumber
accountDigit
accountType
contractId
contractNumber
contractStatus
contractDate

POST /illustrative/v1/payroll-credit/contract-preparation HTTP/1.1
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json

{
  "proposalId": "prop_99120",
  "personDocument": "12345678909",
  "installmentNumber": 60,
  "bankAccount": {
    "bankCode": "260",
    "agencyNumber": "0001",
    "accountNumber": "123456",
    "accountDigit": "7",
    "accountType": "CHECKING"
  }
}

{
  "contractId": "ctr_55120",
  "contractNumber": "202600055120",
  "contractStatus": "PENDING",
  "contractDate": "2026-10-25"
}

推荐贷款方案
GET /illustrative/v1/payroll-credit/suggested-offers openbanking
返回为客户生成的预批准贷款方案集合，包括优惠方案界面展示的再融资与转贷方案。
认证方式：使用 Bearer access_token。
- proposals
- proposalId
- proposalValue
- installments
- installmentValue
- monthlyInterest
```
GET /illustrative/v1/payroll-credit/suggested-offers HTTP/1.1
Authorization: Bearer <ACCESS_TOKEN>
```
```
{
  "proposals": [
    {
      "proposalId": "prop_99120",
      "proposalValue": 5000,
      "installments": 84,
      "installmentValue": 92.4,
      "monthlyInterest": 1.79
    }
  ]
}
```

上传并核验个人证件

POST /illustrative/v1/payroll-credit/identity-document-check openbanking

上传 RG/CNH 证件的正反面图像，并执行合同正式办理前所需的 OCR 识别与证件核验。

认证方式：使用 Bearer access_token；以 multipart 格式上传证件图像。

documentType
file
documentStatus
personDocument
documentFront
documentBack

POST /illustrative/v1/payroll-credit/identity-document-check HTTP/1.1
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: multipart/form-data; boundary=----meutudo

------meutudo
Content-Disposition: form-data; name="documentType"

RG_FRONT
------meutudo
Content-Disposition: form-data; name="file"; filename="rg.jpg"
Content-Type: image/jpeg

<binary>
------meutudo--

{
  "documentType": "RG_FRONT",
  "documentStatus": "APPROVED",
  "personDocument": "12345678909"
}

FaceTec 生物识别会话
POST /illustrative/v1/payroll-credit/liveness-session openbanking
签发 FaceTec 会话令牌，供注册、合同签署和 PIX 生物识别流程中的三维活体核验与人脸比对使用。
认证方式：使用 Bearer access_token。返回的 sessionToken 随后供 FaceTec 三维活体核验 SDK 使用。
- personDocument
- sessionToken
```
POST /illustrative/v1/payroll-credit/liveness-session HTTP/1.1
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json

{
  "personDocument": "12345678909"
}
```
```
{
  "sessionToken": "<SESSION_TOKEN>"
}
```

合同详情

GET /illustrative/v1/payroll-credit/contract-record openbanking

读取一份合同的状态、分期计划、首期还款信息和放款账户，供合同详情界面展示。

认证方式：使用 Bearer access_token。

contractNumber
contractId
contractStatus
installmentValue
installments
firstPaymentDate
dueDate
totalAmount
bankAccount
bankCode
agencyNumber
accountNumber
accountDigit

GET /illustrative/v1/payroll-credit/contract-record?contractNumber=202600055120 HTTP/1.1
Authorization: Bearer <ACCESS_TOKEN>

{
  "contractId": "ctr_55120",
  "contractNumber": "202600055120",
  "contractStatus": "RUNNING",
  "installmentValue": 92.4,
  "installments": 84,
  "firstPaymentDate": "2026-11-10",
  "dueDate": "2026-11-10",
  "totalAmount": 7761.6,
  "bankAccount": {
    "bankCode": "260",
    "agencyNumber": "0001",
    "accountNumber": "123456",
    "accountDigit": "7"
  }
}

缴款单（boleto）

GET /illustrative/v1/payroll-credit/installment-slip openbanking

获取生效中合同的下一期或指定期次的 boleto 缴款单。

认证方式：使用 Bearer access_token。

contractNumber
installmentNumber
dueDate
installmentAmount
totalAmount

GET /illustrative/v1/payroll-credit/installment-slip?contractNumber=202600055120 HTTP/1.1
Authorization: Bearer <ACCESS_TOKEN>

{
  "contractNumber": "202600055120",
  "installmentNumber": 3,
  "dueDate": "2027-01-10",
  "installmentAmount": 92.4,
  "totalAmount": 92.4
}

数据类别

工资代扣贷款
INSS 可扣款额度
FGTS 基金
贷款试算
合同
身份核验证件
还款计划
代扣信用卡

数据使用场景与案例

可扣款额度监测
以 nb、nit 和 marginCode 识别 INSS 福利记录，跟踪其 availableMargin、usedMargin、reservedMargin 与 marginFuture，帮助贷款经纪或信贷团队在发起新一轮试算前发现可用额度的变化。
试算报价与合同核对
将试算返回的 installmentValue、monthlyInterest、cetYearlyRate 和 totalAmount，与后续合同中记录的 contractStatus、firstPaymentDate 和 installments 进行比对。
开户与身份核验流程衔接
串联各个注册步骤：CPF 查询、短信 smsToken 验证、按邮政编码补全地址（zipCode、street、neighborhood、city、state）、证件正反面上传，以及通过 FaceTec sessionToken 完成活体核验。
还款与放款跟踪
读取 contractNumber、dueDate、installmentAmount，以及放款账户 bankAccount 中的 bankCode、agencyNumber、accountNumber 和 accountDigit，核对工资代扣记录与缴款单。

常见问题

meutudo 提供哪些代扣贷款数据？

包括 INSS 可扣款额度明细（availableMargin、usedMargin、reservedMargin、marginFuture）、福利标识（nb、nit）、试算报价（installmentValue、monthlyInterest、cetYearlyRate、totalAmount），以及贷款方案与合同记录（contractNumber、contractStatus、dueDate、firstPaymentDate）。

示例包含哪些 INSS 试算方案？

示例包括以 INSS_CONSIGNADO 为 product 的代扣贷款试算，以及用于 PIX 代扣或未来额度方案的 INSS 专项试算。展示的 PIX 请求使用 type CONSIGNED_PIX，响应包含 proposalId、proposalValue、installmentValue、installments 和 firstPaymentDate。

不同调用之间如何识别同一位客户？

personDocument（CPF）在注册、证件核验和生物识别会话请求中标识客户；需认证的调用携带 Bearer access_token。INSS 试算通过 enrollment 选择福利，福利列表则提供 nb、nit 和 enrollmentName；并非每个请求都同时发送这些标识。

是否包含还款数据？

包含。合同详情返回 installments、installmentValue 和 firstPaymentDate；缴款单调用则返回指定期次 boleto 对应的 installmentNumber、dueDate 和 installmentAmount。

与 meutudo. Empréstimo CLT e INSS 相似的应用

Banco Bmg — Banco Bmg 为 INSS 退休金和养老金领取人提供从待遇中代扣的工资贷（最长 108 期），并为正式受雇职工提供最长 60 期从工资代扣的 consignado CLT。
Creditas — Creditas 的 Empréstimo Consignado Privado（Crédito do Trabalhador）面向 CLT 职工，分期从工资代扣，额度为起借 500 雷亚尔、期限 6 至 48 个月，可通过 Creditas 应用或 CTPS Digital 申请。
Agibank — Agibank 提供面向公职人员的工资代扣贷款、Crédito do Trabalhador 职工信贷以及工资贷转移（portabilidade），可通过其应用和全国网点办理。
Facio — Facio（Facio Pagamentos）作为 QI Tech SCD 的银行业务代理，在巴西提供 Crédito Fácil 个人信贷，经授信评估后将款项打入借款人账户，并在自选日期一次性还款。
Serasa: Consulta CPF e Score — Serasa 消费端应用可查询 CPF 与 Serasa Score、通过 Limpa Nome 协商逾期债务，并在其信贷市场中模拟信用卡、个人贷款和私人部门工资代扣（consignado privado）报价。
Crediamigo — Crediamigo 是巴西东北银行面向小微经营者的城市小额信贷项目，提供流动资金、固定资产投资和女性创业信贷，客户可在 Crediamigo 应用中查看自己的额度与合同。

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

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

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

获取报价

meutudo 数据 API：额度、贷款与合同

应用截图

API 端点一览

CPF 注册状态查询

密码登录

短信验证码验证

按邮政编码查询地址

贷款资格预检查

INSS 福利列表

INSS 可扣款额度明细

贷款试算

INSS 试算（PIX 代扣／未来额度）

合同准备

推荐贷款方案

上传并核验个人证件

FaceTec 生物识别会话

合同详情

缴款单（boleto）

数据类别

数据使用场景与案例

可扣款额度监测

试算报价与合同核对

开户与身份核验流程衔接

还款与放款跟踪

常见问题

与 meutudo. Empréstimo CLT e INSS 相似的应用

更多信贷类应用

BAF Mobile - Cicilan Pinjaman

Bright: Loans & Credit Builder

Brigit: Cash Advance & Credit

Cairin: Pinjaman Daring Cepat

相关主题

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

meutudo 数据 API：额度、贷款与合同

应用截图

API 端点一览

CPF 注册状态查询

密码登录

短信验证码验证

按邮政编码查询地址

贷款资格预检查

INSS 福利列表

INSS 可扣款额度明细

贷款试算

INSS 试算（PIX 代扣／未来额度）

合同准备

推荐贷款方案

上传并核验个人证件

FaceTec 生物识别会话

合同详情

缴款单（boleto）

数据类别

数据使用场景与案例

可扣款额度监测

试算报价与合同核对

开户与身份核验流程衔接

还款与放款跟踪

常见问题

相关应用

与 meutudo. Empréstimo CLT e INSS 相似的应用

更多信贷类应用

BAF Mobile - Cicilan Pinjaman

Bright: Loans & Credit Builder

Brigit: Cash Advance & Credit

Cairin: Pinjaman Daring Cepat

相关主题

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