Facio 月度额度与 PIX Inteligente 数据 API

Facio · 信贷 4.9 ★

Facio 是 Fácio Pagamentos Ltda 的 Android 现金信贷客户端。该公司位于圣保罗 Pinheiros 的 Rua Cláudio Soares 72，Conjunto 115（邮编 05422-030），用户在应用内注册并通过信贷分析后，把月度额度打到巴西银行账户。借款人起步额度为公布的 R$ 50，还清后同一额度重新开放；可维持单期还款，或在解锁 parcelamento 后改走多期。同一客户端还提供 Open Finance 银行连接（Nubank、Itaú、Bradesco、Santander、Inter、C6、Caixa、Banco do Brasil、PicPay、Mercado Pago 等）、PIX Inteligente 还款、PIX 与 boleto 账单、Mastercard 合作入口、工资贷与薪资预支产品入口、费率说明页和推荐计划。Google Play 评分 4.9（539,903 条评价），进入巴西免费 Finance 应用前列，下载量 5M+；客服 [email protected]、+55 11 4040-5513。它与其他巴西短期信贷应用争夺需要应急现金的城市用户。

月度循环额度行把 availableLimit 对 usedLimit 写成 BRL 的 totalLimit，按时还款后带 nextReviewDate。报价试算给一笔请款打上 offerId，以及 installmentCount、installmentAmount、monthlyRate、cetAnnual。

Open Finance 授权携带 consentId 与 institutionId；签约现金经 disbursementStatus 打入 destinationAccount，并带 pixEndToEndId。当期应还在 amountDue 上给出 pixCopyPaste 与 boletoBarcode，PIX Inteligente 再补上 authorizationId 与 maxAmount，多期账本则列出 installmentDueDate 与 remainingBalance。催收、资金对账与 CET 对比台使用这些字段；openData Studio 把它们变成可调用的开放数据。

应用截图

API 端点一览

请求/响应示例为依据应用界面重构的示意示例，并非实时抓包。

发送 CPF 验证码

POST /v1/auth/cpf/otp osint

在签发会话前，按 channel 向该 cpf 登记手机发送一次性验证码。

认证方式：登录前调用。请求体 cpf、channel。

otpId
cpf
channel
ttlSec

POST /v1/auth/cpf/otp HTTP/1.1
Host: api.example.invalid
Content-Type: application/json

{
  "cpf": "12345678901",
  "channel": "sms"
}

{
  "otpId": "otp_7f21c9",
  "cpf": "12345678901",
  "channel": "sms",
  "ttlSec": 60
}

CPF 会话签发
POST /v1/auth/cpf/session osint
用 cpf、otpId、otpCode 换取后续调用所需的 accessToken、customerId、onboardingStatus。
认证方式：登录前调用。请求体 cpf、otpId、otpCode。返回 accessToken，供后续 Authorization 头使用。
- accessToken
- customerId
- cpf
- onboardingStatus
```
POST /v1/auth/cpf/session HTTP/1.1
Host: api.example.invalid
Content-Type: application/json

{
  "cpf": "12345678901",
  "otpId": "otp_7f21c9",
  "otpCode": "483920"
}
```
```
{
  "accessToken": "tok_demo_a91e2c",
  "customerId": "cus_1048821",
  "cpf": "12345678901",
  "onboardingStatus": "kyc_pending"
}
```

KYC 证件提交

POST /v1/kyc/submission opendata

提交信贷分析所需的 documentType、documentFrontUrl、selfieUrl，返回 kycStatus 与 livenessPassed。

认证方式： /v1/auth/cpf/session 返回的 accessToken，以 Bearer 携带。

kycId
customerId
documentType
documentFrontUrl
selfieUrl
kycStatus
livenessPassed

POST /v1/kyc/submission HTTP/1.1
Host: api.example.invalid
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "customerId": "cus_1048821",
  "documentType": "rg",
  "documentFrontUrl": "https://cdn.example.invalid/kyc/front.jpg",
  "selfieUrl": "https://cdn.example.invalid/kyc/selfie.jpg"
}

{
  "kycId": "kyc_33ab01",
  "customerId": "cus_1048821",
  "documentType": "rg",
  "kycStatus": "in_review",
  "livenessPassed": true
}

Open Finance 授权

POST /v1/open-finance/consents openfinance

为 institutionId 发起 Open Finance 授权，返回 consentId、bankName、consentStatus 与银行 redirectUrl。

认证方式： /v1/auth/cpf/session 返回的 accessToken，以 Bearer 携带。

consentId
institutionId
bankName
consentStatus
permissions
redirectUrl

POST /v1/open-finance/consents HTTP/1.1
Host: api.example.invalid
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "customerId": "cus_1048821",
  "institutionId": "60701190",
  "permissions": ["ACCOUNTS_READ", "CREDIT_CARDS_ACCOUNTS_READ"]
}

{
  "consentId": "urn:facio:consent:88c2",
  "institutionId": "60701190",
  "bankName": "Itaú",
  "consentStatus": "AWAITING_AUTHORISATION",
  "redirectUrl": "https://shared-consent-openfinance.facio.com.br/itaú"
}

月度循环额度
GET /v1/credit/limit openfinance
读取已登录用户的月度循环额度：availableLimit、usedLimit、totalLimit（BRL）以及按时还款后的 nextReviewDate。
认证方式： /v1/auth/cpf/session 返回的 accessToken，以 Bearer 携带。
- customerId
- availableLimit
- usedLimit
- totalLimit
- currency
- nextReviewDate
```
GET /v1/credit/limit HTTP/1.1
Host: api.example.invalid
Authorization: Bearer <accessToken>
```
```
{
  "customerId": "cus_1048821",
  "availableLimit": 50.00,
  "usedLimit": 0.00,
  "totalLimit": 50.00,
  "currency": "BRL",
  "nextReviewDate": "2026-11-18"
}
```

报价费率试算

POST /v1/offers/simulate openfinance

为 requestedAmount 定价：返回 offerId、installmentCount、installmentAmount、monthlyRate、cetAnnual、totalPayable。

认证方式： /v1/auth/cpf/session 返回的 accessToken，以 Bearer 携带。

offerId
requestedAmount
installmentCount
installmentAmount
monthlyRate
cetAnnual
totalPayable

POST /v1/offers/simulate HTTP/1.1
Host: api.example.invalid
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "customerId": "cus_1048821",
  "requestedAmount": 50.00,
  "installmentCount": 1
}

{
  "offerId": "off_9c41",
  "requestedAmount": 50.00,
  "installmentCount": 1,
  "installmentAmount": 57.80,
  "monthlyRate": 0.156,
  "cetAnnual": 4.92,
  "totalPayable": 57.80
}

签约信贷报价

POST /v1/offers/{offerId}/contract openfinance

把 offerId 签约打到借款人银行账户，返回 contractId、disbursementStatus、destinationAccount、pixEndToEndId。

认证方式： /v1/auth/cpf/session 返回的 accessToken，以 Bearer 携带。

contractId
offerId
disbursementStatus
destinationIspb
destinationAccount
destinationBranch
pixEndToEndId

POST /v1/offers/off_9c41/contract HTTP/1.1
Host: api.example.invalid
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "offerId": "off_9c41",
  "destinationIspb": "60701190",
  "destinationAccount": "12345-6",
  "destinationBranch": "0001"
}

{
  "contractId": "ctr_5510",
  "offerId": "off_9c41",
  "disbursementStatus": "settled",
  "destinationIspb": "60701190",
  "destinationAccount": "12345-6",
  "pixEndToEndId": "E6070119020261019abc"
}

当期账单

GET /v1/bills/current openfinance

返回当期应还：amountDue、dueDate、pixCopyPaste、boletoBarcode、paymentStatus。

认证方式： /v1/auth/cpf/session 返回的 accessToken，以 Bearer 携带。

billId
contractId
amountDue
dueDate
pixCopyPaste
boletoBarcode
paymentStatus

GET /v1/bills/current HTTP/1.1
Host: api.example.invalid
Authorization: Bearer <accessToken>

{
  "billId": "bil_2201",
  "contractId": "ctr_5510",
  "amountDue": 57.80,
  "dueDate": "2026-11-18",
  "pixCopyPaste": "00020126...BR.GOV.BCB.PIX",
  "boletoBarcode": "23793.38128 60000.000003 00000.000400 1 84450000005780",
  "paymentStatus": "waiting_payment"
}

PIX Inteligente 授权

POST /v1/payments/pix-inteligente openfinance

为 billId 发起带 maxAmount 与 recurrence 的 PIX Inteligente 扣款授权，银行回调后返回 authorizationId、authorizationStatus。

认证方式： /v1/auth/cpf/session 返回的 accessToken，以 Bearer 携带。

authorizationId
billId
pixKey
maxAmount
recurrence
authorizationStatus
callbackPath

POST /v1/payments/pix-inteligente HTTP/1.1
Host: api.example.invalid
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "customerId": "cus_1048821",
  "billId": "bil_2201",
  "maxAmount": 57.80,
  "recurrence": "monthly"
}

{
  "authorizationId": "pixint_4410",
  "billId": "bil_2201",
  "pixKey": "12345678901",
  "maxAmount": 57.80,
  "recurrence": "monthly",
  "authorizationStatus": "pending_bank",
  "callbackPath": "/pixInteligente/callback"
}

分期还款计划
GET /v1/installments openfinance
列出合同的多期计划：installmentNumber、installmentAmount、installmentDueDate、installmentStatus、remainingBalance。
认证方式： /v1/auth/cpf/session 返回的 accessToken，以 Bearer 携带。
- contractId
- installmentCount
- remainingBalance
- installmentNumber
- installmentAmount
- installmentDueDate
- installmentStatus
```
GET /v1/installments?contractId=ctr_5510 HTTP/1.1
Host: api.example.invalid
Authorization: Bearer <accessToken>
```
```
{
  "contractId": "ctr_5510",
  "installmentCount": 3,
  "remainingBalance": 115.60,
  "items": [
    {
      "installmentNumber": 1,
      "installmentAmount": 57.80,
      "installmentDueDate": "2026-11-18",
      "installmentStatus": "paid"
    }
  ]
}
```

薪资预支登记

POST /v1/advance/signup openfinance

用 requestedAmount 与 payday 发起薪资预支申请，回调后返回 advanceId、advanceStatus。

认证方式： /v1/auth/cpf/session 返回的 accessToken，以 Bearer 携带。

advanceId
customerId
requestedAmount
payday
advanceStatus
callbackPath

POST /v1/advance/signup HTTP/1.1
Host: api.example.invalid
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "customerId": "cus_1048821",
  "requestedAmount": 200.00,
  "payday": "2026-10-30"
}

{
  "advanceId": "adv_8821",
  "customerId": "cus_1048821",
  "requestedAmount": 200.00,
  "payday": "2026-10-30",
  "advanceStatus": "pending_employer",
  "callbackPath": "/advance/signup/callback"
}

推荐码
GET /v1/referrals opendata
返回已登录借款人的 referralCode、referredCount、bonusAmount。
认证方式： /v1/auth/cpf/session 返回的 accessToken，以 Bearer 携带。
- customerId
- referralCode
- referredCount
- bonusAmount
- currency
```
GET /v1/referrals HTTP/1.1
Host: api.example.invalid
Authorization: Bearer <accessToken>
```
```
{
  "customerId": "cus_1048821",
  "referralCode": "FACIO-ANA7",
  "referredCount": 2,
  "bonusAmount": 20.00,
  "currency": "BRL"
}
```

数据类别

CPF 会话
KYC 证件
Open Finance 授权
循环信贷额度
定价信贷报价
放款
PIX 与 boleto 账单
PIX Inteligente 授权
分期计划
薪资预支
推荐

数据使用场景与案例

循环额度监控
催收看板轮询 availableLimit、usedLimit 与 nextReviewDate，避免 overdue 的 dueDate 在无提示下冻住下一笔垫资。
PIX Inteligente 与 boleto 对账
资金机器人用 pixCopyPaste / pixEndToEndId、boletoBarcode 或 PIX Inteligente 的 authorizationId 对上 billId，翻转 paymentStatus 后重新打开 totalLimit。
Open Finance 授权审计
合规栈按 customerId 保存 consentId、institutionId、consentStatus，说明信贷分析依据哪家银行连接。
报价 CET 对比
定价台归档 offerId 行的 monthlyRate、cetAnnual、installmentCount、totalPayable，比较单期与多期账本。

常见问题

Facio 的信贷额度绑定什么身份？

巴西 CPF。短信验证后会话返回 customerId 与 cpf，KYC 再附上 documentType、自拍活体与 kycStatus，随后才发放首笔 availableLimit。

还款如何重新打开月度额度？

当期账单带 amountDue、dueDate、pixCopyPaste 与 boletoBarcode。PIX Inteligente 可挂上带 maxAmount 与 recurrence 的 authorizationId，由银行在到期日扣款。paymentStatus 结清后 usedLimit 下降、availableLimit 恢复；nextReviewDate 是客户端在连续按时还款后上调 totalLimit 的窗口。

数据里有 Open Finance 银行连接吗？

有。授权行保存 consentId、institutionId、bankName、consentStatus，对应借款人在连接页选择的银行（Itaú、Nubank、Bradesco、Santander 等），供信贷分析读取用户授权的账户。

单期还是分期？

报价试算同时返回 installmentCount、installmentAmount、monthlyRate、cetAnnual。默认是 30 天单期；多期合同再列出 installmentNumber 行与 remainingBalance。另外还有薪资预支轨道，带 advanceId、payday、advanceStatus。

与 Facio 相似的应用

Blipay — Blipay 是巴西薪资预支应用，职工每月最多可预支已赚工资中的 1,000 雷亚尔，几分钟内打到自选银行账户，发薪日连同一笔固定手续费偿还，不收复利。
Jeitto — Jeitto 是巴西银行业务代理，应用内个人信贷额度从 250 到 3,000 雷亚尔、期限 3 至 24 个月，可用 Pix 或 boleto 还款。
RecargaPay — RecargaPay 是受巴西央行监管的支付机构，应用内个人贷款起步 10 雷亚尔、全天可申请，批准后经 Pix 打入 RecargaPay 账户，除分期外还有短期选项。
PicPay — PicPay 钱包里出现预批额度时，个人贷款会打入 PicPay 账户，首期最多可延至 45 天；同一入口还提供面向正式雇员（carteira assinada）的工资代扣信贷。
SuperSim — SuperSim 是巴西在线个人贷款平台，用 CPF 几分钟内提交申请，获批后经 Pix 放款，也面向征信有负面记录的借款人给出报价。
Simplic — Simplic 是 2014 年成立于圣保罗的银行业务代理，做无抵押个人贷款：线上信贷分析通过后把资金打入借款人银行账户，宣传到账最长 48 小时。
Nubank — Nubank 的无抵押个人贷款在应用内模拟金额、期数和还款日后签约，同一贷款入口还提供从工资单代扣的 CLT 工资贷（consignado）。
Serasa Crédito — Serasa Crédito 是 Serasa 的信贷比价入口，用 CPF 模拟后会返回 Jeitto、Simplic 等合作机构的个人贷款和信用卡报价，供借款人签约前比较条件。

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

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

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

获取报价

Facio 月度额度与 PIX Inteligente 数据 API

应用截图

API 端点一览

发送 CPF 验证码

CPF 会话签发

KYC 证件提交

Open Finance 授权

月度循环额度

报价费率试算

签约信贷报价

当期账单

PIX Inteligente 授权

分期还款计划

薪资预支登记

推荐码

数据类别

数据使用场景与案例

循环额度监控

PIX Inteligente 与 boleto 对账

Open Finance 授权审计

报价 CET 对比

常见问题

与 Facio 相似的应用

更多信贷类应用

Brigit: Cash Advance & Credit

Cairin: Pinjaman Daring Cepat

CASHe: Quick Personal Loan App

Dave: Credit, Cash & Money App

相关主题

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

Facio 月度额度与 PIX Inteligente 数据 API

应用截图

API 端点一览

发送 CPF 验证码

CPF 会话签发

KYC 证件提交

Open Finance 授权

月度循环额度

报价费率试算

签约信贷报价

当期账单

PIX Inteligente 授权

分期还款计划

薪资预支登记

推荐码

数据类别

数据使用场景与案例

循环额度监控

PIX Inteligente 与 boleto 对账

Open Finance 授权审计

报价 CET 对比

常见问题

相关应用

与 Facio 相似的应用

更多信贷类应用

Brigit: Cash Advance & Credit

Cairin: Pinjaman Daring Cepat

CASHe: Quick Personal Loan App

Dave: Credit, Cash & Money App

相关主题

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