InfinitePay 数据 API：nsu 签购、Pix 与钱包

CloudWalk · 支付 4.9 ★

InfinitePay Tap, Conta, Cartão 是 CloudWalk 面向巴西商户的应用（设备上显示 InfinitePay）：一部 Android 10 及以上、带 NFC 的手机即可当作免费的 InfiniteTap 读卡器，并配上 PF/PJ 数字账户、零费率 Pix、付款链接、催收、门店库存以及一张免年费智能卡。店主、MEI、CNPJ 企业与外卖骑手用手机感应接受借记、贷记和数字钱包——超过 200 雷亚尔的交易会要求顾客输入密码——然后选择即时到账或 1 个工作日到账，费率已包含预支成本。团队模式（Modo Equipe）可在任意多部手机上安装仅用于收款的受限客户端；同一登录还能生成最长 12 期的分期链接发到 WhatsApp 和私信、开具 Pix 或银行卡催收、维护在线目录、在应用内比较 MDR，并可用销售额偿还即时贷款。智能卡消费返现 1.5%，可加入手机钱包。应用仅在巴西上架（CloudWalk 支付机构 CNPJ 18.189.547/0001-42，圣保罗 Rua Eugênio de Medeiros 303），Google Play 评分 4.87、约 104 万条评价、安装量超过 1000 万，免费财经榜约第 7，与 Stone、PagBank、Cielo、Mercado Pago Point、SumUp 和 Ton 争夺同一软 POS 加数字账户位置。

CNPJ document_number 与 wallets、cardholder、products_allowed 出现在同一商户会话里，identity_validation 状态和 account_kind（MerchantPj 对 CPF 卖家）决定收银机是不是对公户。软 POS 与配送点付随后用 nsu 索引每笔银行卡签购；Pix 出金记录在 current_tpv 旁，而 active_loan 与卡片 credit_statement 复用同一个 handle。

ERP 与骑手系统再拿应收的 reference_id 和 BACEN 核验状态对账，让一部 Android 10 手机上的 NFC、零费率 Pix 和免年费卡可以在没有单独收单文件的情况下完成日结。openData Studio 把该商户会话变成可调用的开放数据。

应用截图

API 端点一览

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

校验登录密码
POST /v1/merchants/sign-in opendata
确认商户密码，并返回后续第一方请求作为 Bearer 使用的 jwt_token 与 payload.message 资料。
认证方式：无需令牌。凭 CPF/CNPJ handle 加密码。成功后返回 jwt_token，后续请求作为 Bearer 令牌携带。
- handle
- password
- device_authenticated
- jwt_token
- payload.message
- id
- has_password
- is_company
```
POST /v1/merchants/sign-in HTTP/1.1
Content-Type: application/json

{
  "handle": "loja.centro",
  "password": "********",
  "device_authenticated": true
}
```
```
{
  "jwt_token": "<jwt_token>",
  "payload": {
    "message": {
      "id": 88412019,
      "handle": "loja.centro",
      "has_password": true,
      "is_company": true
    }
  }
}
```
列出有效登录会话
GET /v1/merchants/me/devices opendata
列出该商户登录下仍在线的设备，便于在安全设置里吊销团队模式手机与店主收银机。
认证方式：携带密码或二维码登录签发的 Authorization: Bearer jwt_token。
- sessions
- id
- handle
- device_authenticated
- ip_address
- received_at
```
GET /v1/merchants/me/devices HTTP/1.1
Authorization: Bearer <jwt_token>
```
```
{
  "sessions": [
    {
      "id": "sess-1a2b",
      "handle": "loja.centro",
      "device_authenticated": true,
      "ip_address": "203.0.113.10",
      "received_at": "2026-10-17T11:02:01Z"
    }
  ]
}
```

当前商户会话

GET /v1/merchants/me/profile openfinance

加载已登录的 PF/PJ 商户：wallets、cardholder、CNPJ document_number、products_allowed 与 legal_representative，供首页账户与收银机使用。

认证方式：携带密码或二维码登录返回的 Bearer jwt_token。

include
payload.message
id
handle
user_handle
phone_number
is_company
avatar_url
cover_url
products_allowed
identity_validation
wallets
currency
amount
cardholder
merchant
document_number
legal_representative

GET /v1/merchants/me/profile?include=wallets,cardholder,merchant HTTP/1.1
Authorization: Bearer <jwt_token>

{
  "payload": {
    "message": {
      "id": 88412019,
      "handle": "loja.centro",
      "user_handle": "loja.centro",
      "phone_number": "11987654321",
      "is_company": true,
      "avatar_url": "https://static.example.com/avatars/88412019.png",
      "cover_url": "https://static.example.com/covers/88412019.png",
      "products_allowed": ["tap", "pix", "payment_links", "card"],
      "identity_validation": {"status": "approved"},
      "wallets": [{"id": "wal-brl", "currency": "BRL", "amount": "18450.20"}],
      "cardholder": {"name": "Ana Souza"},
      "merchant": {"document_number": "12345678000195"},
      "legal_representative": {"document_number": "12345678901"}
    }
  }
}

BACEN 核验状态
GET /v1/merchants/me/compliance/status osint
读取商户的 BACEN / identity_validation 状态，以便在实名通过后解锁 Pix、信贷与卡片产品。
认证方式：携带密码或二维码登录签发的 Bearer jwt_token。
- identity_validation
- status
- bacen_validations
- invalid_data
- document_number
```
GET /v1/merchants/me/compliance/status HTTP/1.1
Authorization: Bearer <jwt_token>
```
```
{
  "identity_validation": {
    "status": "approved"
  },
  "bacen_validations": {
    "status": "approved",
    "invalid_data": false
  },
  "document_number": "12345678000195"
}
```

含商户信息的法律实体

GET /v1/entities/{entity_id} osint

返回法律实体及嵌套的 merchant.document_number，含 account_kind（MerchantPj 对 PF），用于 CNPJ/CPF 切换与选择账户。

认证方式：携带密码或二维码登录签发的 Bearer jwt_token。

id
account_kind
handle
user_id
status
roles
merchant
document_number
accounts

GET /v1/entities/88412019?include=merchant HTTP/1.1
Authorization: Bearer <jwt_token>

{
  "id": 88412019,
  "account_kind": "MerchantPj",
  "handle": "loja.centro",
  "user_id": 88412019,
  "status": "active",
  "roles": ["owner"],
  "merchant": {
    "document_number": "12345678000195"
  },
  "accounts": [
    {
      "user_id": 88412019,
      "account_kind": "MerchantPj",
      "handle": "loja.centro",
      "status": "active",
      "roles": ["owner"]
    }
  ]
}

捕获 InfiniteTap NFC 签购

POST /v1/payments/contactless/capture openbanking

在 Android 10 及以上 NFC 手机上授权一笔 InfiniteTap 非接触签购，并返回销售界面用来索引的 nsu。

认证方式：携带具备支付写入范围的 Bearer jwt_token。

amount
currency
installments
entry_mode
handle
nsu
status
instant_transactions
transaction_info
brand

POST /v1/payments/contactless/capture HTTP/1.1
Authorization: Bearer <jwt_token>
Content-Type: application/json

{
  "amount": "199.90",
  "currency": "BRL",
  "installments": 1,
  "entry_mode": "nfc",
  "handle": "loja.centro"
}

{
  "nsu": "314159265",
  "status": "approved",
  "amount": "199.90",
  "currency": "BRL",
  "instant_transactions": true,
  "transaction_info": {
    "entry_mode": "nfc",
    "brand": "mastercard"
  }
}

索引已捕获销售

GET /v1/sales/daily opendata

分页返回商户当日已捕获交易额（current_tpv）以及按 nsu 列出的销售，供分析与费率界面使用。

认证方式：携带具备财务读取范围的 Bearer jwt_token。

date
handle
current_tpv
currency
sales
nsu
amount
status
received_at

GET /v1/sales/daily?date=2026-10-17&handle=loja.centro HTTP/1.1
Authorization: Bearer <jwt_token>

{
  "current_tpv": "18450.20",
  "currency": "BRL",
  "sales": [
    {
      "nsu": "314159265",
      "amount": "199.90",
      "status": "approved",
      "received_at": "2026-10-17T14:02:11Z"
    }
  ]
}

按 NSU 读取签购单

GET /v1/receipts/{nsu} openbanking

按 nsu 返回一笔已捕获销售，供签购单、拒付与费率下钻使用。

认证方式：携带 Bearer jwt_token。

nsu
amount
currency
status
handle
transaction_info
entry_mode
brand
received_at

GET /v1/receipts/314159265 HTTP/1.1
Authorization: Bearer <jwt_token>

{
  "nsu": "314159265",
  "amount": "199.90",
  "currency": "BRL",
  "status": "approved",
  "handle": "loja.centro",
  "transaction_info": {
    "entry_mode": "nfc",
    "brand": "mastercard"
  },
  "received_at": "2026-10-17T14:02:11Z"
}

Pix 转出

POST /v1/transfers/pix openbanking

从商户会话的 PF/PJ wallets 发起 Pix 转出，即与 InfiniteTap 并列宣传的零费率、不限额 Pix 轨道。

认证方式：携带 Bearer jwt_token。需要 identity_validation 为 approved。

amount
currency
handle
pix_key
status
reference_id
received_at

POST /v1/transfers/pix HTTP/1.1
Authorization: Bearer <jwt_token>
Content-Type: application/json

{
  "amount": "350.00",
  "currency": "BRL",
  "handle": "loja.centro",
  "pix_key": "[email protected]"
}

{
  "status": "sent",
  "amount": "350.00",
  "currency": "BRL",
  "reference_id": "pix-9f21",
  "received_at": "2026-10-17T14:08:00Z"
}

按 reference 读取应收
GET /v1/settlements/{reference_id} openfinance
按 reference_id 读取一笔应收（1 个工作日预支或分期计划），供收款界面使用。
认证方式：携带 Bearer jwt_token。
- reference_id
- nsu
- amount
- currency
- status
- receivables_details
- settle_in_days
- allow_payment_after_due_date
```
GET /v1/settlements/recv-8841 HTTP/1.1
Authorization: Bearer <jwt_token>
```
```
{
  "reference_id": "recv-8841",
  "nsu": "314159265",
  "amount": "199.90",
  "currency": "BRL",
  "status": "prepaid",
  "receivables_details": {
    "settle_in_days": 1,
    "allow_payment_after_due_date": false
  }
}
```

列出已发卡

GET /v1/cards/issued openfinance

列出免年费智能卡（1.5% 返现）及其嵌套的 credit_statement 行，供智能卡界面使用。

认证方式：携带具备发卡范围的 Bearer jwt_token。

cards
id
cardholder
products_allowed
cashback_rate
credit_statement
amount
currency

GET /v1/cards/issued HTTP/1.1
Authorization: Bearer <jwt_token>

{
  "cards": [
    {
      "id": "crd-1",
      "cardholder": {"name": "Ana Souza"},
      "products_allowed": ["virtual", "physical"],
      "cashback_rate": "0.015",
      "credit_statement": {
        "id": "stmt-10",
        "amount": "620.00",
        "currency": "BRL"
      }
    }
  ]
}

以销售额为锚的贷款快照
GET /v1/financing/instant-loan openfinance
读取按已捕获 current_tpv 定价的即时贷款（Empréstimo Inteligente），对应应用内两步确认的报价。
认证方式：携带具备信贷范围的 Bearer jwt_token。
- handle
- account_kind
- current_tpv
- active_loan
- id
- amount
- currency
- status
```
GET /v1/financing/instant-loan HTTP/1.1
Authorization: Bearer <jwt_token>
```
```
{
  "handle": "loja.centro",
  "account_kind": "MerchantPj",
  "current_tpv": "18450.20",
  "active_loan": {
    "id": "loan-22",
    "amount": "5000.00",
    "currency": "BRL",
    "status": "open"
  }
}
```

数据类别

账户
实名核验
余额
签购
Pix
应收
卡片
信贷

数据使用场景与案例

软 POS 与配送 NSU 对账
门店或暗厨 ERP 按 nsu 拉取每笔 InfiniteTap 签购，把 amount、current_tpv 对到骑手手机，并标出团队模式中非当班结清的收银机。
Pix 转出与钱包余量
资金台读取商户会话里的 wallets，向供应商发起 Pix 转出，并在 identity_validation 仍为 pending 时停掉出金。
应收与 MDR 日结
财务按 reference_id 遍历 receivables，对照每日销售列表，让 1 个工作日预支和分期计划与收银机落在同一本账里。
以销售额为锚的贷款观察
信贷台把 active_loan 和 current_tpv、account_kind 放在一起，让 CNPJ 商户的即时贷款按已捕获交易额来定，而不是只看征信档案。

常见问题

登录会话返回哪些商户字段？

GET /v1/merchants/me/profile 在附上密码或二维码登录签发的 JWT 后，返回 wallets、cardholder、merchant.document_number、products_allowed、legal_representative、identity_validation、handle、is_company、phone_number 与 avatar_url。

InfiniteTap 的银行卡销售如何标识？

每笔签购存在 nsu 下。GET /v1/sales/daily 按日列出并附带 current_tpv；GET /v1/receipts/{nsu} 返回收银机、团队模式手机或骑手刚收的那张签购单，应收则另用 reference_id 索引。

数据面是否覆盖 Pix 和数字账户？

覆盖。商户资料里的 wallets 就是 PF/PJ 账户；POST /v1/transfers/pix 向外打 Pix；current_tpv 是即时贷款和出金限额所依据的已捕获交易额。收银机上的 Pix 收款是与 NFC 并列的零费率销售轨道。

InfinitePay 如何认证商户？

通过 POST /v1/merchants/sign-in 校验密码，或由已配对手机发起二维码登录。签发的 jwt_token 在后续第一方调用中作为 Bearer Authorization 携带；GET /v1/merchants/me/devices 列出仍在线的设备。

与 InfinitePay Tap, Conta, Cartão 相似的应用

Ton: maquininha, tap e conta — Stone Pagamentos 面向巴西 MEI 和小店的商户应用，把实体 Ton 刷卡机和手机上的 TapTon NFC 收款与免费 Conta Ton 绑在一起，柜台可收 Pix，还能发付款链接并配一张免年费卡。
Stone — Stone 的 TapStone 把带 NFC 的手机变成读卡器，费率与实体 Stone 刷卡机相同，并挂在免费 Conta PJ 上，面向规模更大的巴西商户提供 Pix、付款链接、boleto 和营运资金贷款。
PagBank — PagBank 的 Tap On 可在手机上感应收借记和贷记，无需另买硬件，并与 Moderninha 刷卡机、免费 PF/PJ 数字账户和不限额 Pix 一起提供给巴西商户。
Mercado Pago Point Tap — Mercado Pago Point Tap 把 Android 10 及以上 NFC 手机或 iPhone 11 及以上变成非接触收银，并与 Point 刷卡机、Pix 二维码和 Mercado Pago 数字账户一起用于巴西当面收款。
Cielo Tap — Cielo Tap 内置于 Cielo Gestão 应用，可在手机上感应收借记、贷记和钱包且无月费，并与 Cielo Flash、Smart 终端以及即时 Pix 并列。
SumUp — 巴西 SumUp 让卖家免费用手机感应收款，也可配实体刷卡机，并经由 SumUp 数字账户收发免费 Pix。
Getnet Get Tap — 桑坦德旗下 Getnet 的 Get Tap 把智能手机变成收银机，可收借记、最长 12 期贷记和 Pix，并配 Get Mini、Smart 终端以及两个工作日结算的免费 Get Conta。

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

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

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

获取报价

InfinitePay 数据 API：nsu 签购、Pix 与钱包

应用截图

API 端点一览

校验登录密码

列出有效登录会话

当前商户会话

BACEN 核验状态

含商户信息的法律实体

捕获 InfiniteTap NFC 签购

索引已捕获销售

按 NSU 读取签购单

Pix 转出

按 reference 读取应收

列出已发卡

以销售额为锚的贷款快照

数据类别

数据使用场景与案例

软 POS 与配送 NSU 对账

Pix 转出与钱包余量

应收与 MDR 日结

以销售额为锚的贷款观察

常见问题

与 InfinitePay Tap, Conta, Cartão 相似的应用

更多支付类应用

BharatPe for Business

BrasilCard Cliente

BukuWarung Apps for MSMEs

CashBook - Balance & Expense

相关主题

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

InfinitePay 数据 API：nsu 签购、Pix 与钱包

应用截图

API 端点一览

校验登录密码

列出有效登录会话

当前商户会话

BACEN 核验状态

含商户信息的法律实体

捕获 InfiniteTap NFC 签购

索引已捕获销售

按 NSU 读取签购单

Pix 转出

按 reference 读取应收

列出已发卡

以销售额为锚的贷款快照

数据类别

数据使用场景与案例

软 POS 与配送 NSU 对账

Pix 转出与钱包余量

应收与 MDR 日结

以销售额为锚的贷款观察

常见问题

相关应用

与 InfinitePay Tap, Conta, Cartão 相似的应用

更多支付类应用

BharatPe for Business

BrasilCard Cliente

BukuWarung Apps for MSMEs

CashBook - Balance & Expense

相关主题

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