Ton 商户数据 API：余额、Pix、销售与 Open Finance

Stone Pagamentos S.A. · 支付

Ton: maquininha, tap e conta 是 Stone Pagamentos S.A. 面向巴西 MEI、CNPJ 商户和个体卖家的商户应用。它把实体 Ton 刷卡机和手机上的 TapTon NFC 收款，与 Stone 的数字账户 conta（COMPE 197 / Stone Pagamentos S.A.）结合在一起，同一个登录就能在柜台完成线下借记卡、信用卡和 Pix 收款，开具付款链接和 boleto，管理 Stone 银行卡钱包，预支应收款，并运行 Indique e ganhe 额外收入计划。首页快捷入口还能打开 Open Finance 共享、信贷与融资、保险、薪资、recarga（充值）和团队档案。该应用仅在巴西上架，与 InfinitePay、PagBank、Mercado Pago Point、Cielo Lio 和 SumUp 同属“SoftPOS 加账户”这一赛道。

首页组件把按月已结算的刷卡应收款，用 paidMonthly 与 futureReceivables 配成一对；账户快照则给出 availableAmount、label 和 value。Pix 密钥目录返回 key、keyType 和 isSalesKey；Open Finance 已授权账户带有 accountId、branchCode、compeCode 和 companyCnpj，其对账单分页返回 transactionId、creditDebitType 和 partieCnpjCpf。柜台刷卡销售的每一行再加上 saleId、charge_id 和 cardLastDigits。ERP 对账工具、以应收款为依据的放款机构和多银行现金流工具都会读取这些对象——openData Studio 把它们转换为可调用的开放数据。

应用截图

API 端点一览

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

读取数字账户余额
GET /v1/wallet/{account_id}/snapshot openbanking
读取已登录商户的数字账户快照，供首页余额组件使用，包含展示用的 label/value 键值对，以及 otherBalances 或循环信贷（revolving credit）卡片。
认证方式：登录商户账户时签发的 Bearer 会话令牌，登录后的每次调用都会附带。
- status
- balanceInfo
- label
- value
- otherBalances
- benefits
- availableAmount
- investments
- creditRevolving
```
GET /v1/wallet/acc-ton-8841/snapshot HTTP/1.1
Authorization: Bearer <access_token>
```
```
{
  "status": "show_balance",
  "balanceInfo": {
    "label": "Saldo disponível",
    "value": "R$ 12.430,50",
    "otherBalances": [],
    "benefits": []
  },
  "availableAmount": {
    "amount": 1243050,
    "currency": "BRL"
  },
  "investments": null,
  "creditRevolving": null
}
```
列出商户账户
GET /v1/wallet/accounts openbanking
列出绑定到已登录商户的 Stone 数字账户，账户选择器可据此切换收款机、Pix 和对账单所用的账户上下文。
认证方式：登录商户账户时签发的 Bearer 会话令牌，登录后的每次调用都会附带。
- accounts
- account_id
- stone_account_id
- stoneCode
- document
```
GET /v1/wallet/accounts HTTP/1.1
Authorization: Bearer <access_token>
```
```
{
  "accounts": [
    {
      "account_id": "acc-ton-8841",
      "stone_account_id": "sa-197-8841",
      "stoneCode": "123456789",
      "document": "12345678000190"
    }
  ]
}
```
列出 Pix 密钥
GET /v1/instant-pay/{account_id}/aliases openfinance
返回商户账户上登记的 Pix 密钥，包含由 isSalesKey 标记的收款机销售密钥。
认证方式：登录商户账户时签发的 Bearer 会话令牌，登录后的每次调用都会附带。
- data
- id
- key
- keyType
- isSalesKey
- nickname
```
GET /v1/instant-pay/acc-ton-8841/aliases HTTP/1.1
Authorization: Bearer <access_token>
```
```
{
  "data": [
    {
      "id": "pix-key-01",
      "key": "12345678000190",
      "keyType": "CNPJ",
      "isSalesKey": true,
      "nickname": "Loja Centro"
    }
  ]
}
```

创建静态 Pix 二维码

POST /v1/instant-pay/{account_id}/static-codes openfinance

用已登记的密钥为柜台签发静态 Pix 二维码（收款机 Pix 二维码 / chave），返回 EMV 载荷和图片。

认证方式：登录商户账户时签发的 Bearer 会话令牌，登录后的每次调用都会附带。

accountId
key
amount
additionalInformation
transactionId
type
qrCodeImage
qrCodeContent

POST /v1/instant-pay/acc-ton-8841/static-codes HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "accountId": "acc-ton-8841",
  "key": "12345678000190",
  "amount": 15000,
  "additionalInformation": "Pedido 4412",
  "transactionId": "txn-pix-4412",
  "type": "STATIC"
}

{
  "key": "12345678000190",
  "amount": 15000,
  "qrCodeImage": "data:image/png;base64,...",
  "qrCodeContent": "00020101021226870014br.gov.bcb.pix...",
  "additionalInformation": "Pedido 4412",
  "transactionId": "txn-pix-4412"
}

发起转出 Pix
POST /v1/instant-pay/transfers openfinance
从商户 conta 发起一笔转出 Pix；之后用返回的 pixId 做状态查询来轮询这笔转账。
认证方式：登录商户账户时签发的 Bearer 会话令牌，登录后的每次调用都会附带。
- account_id
- amount
- key
- keyType
- pixId
- status
```
POST /v1/instant-pay/transfers HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "account_id": "acc-ton-8841",
  "amount": 25000,
  "key": "11999990000",
  "keyType": "PHONE"
}
```
```
{
  "pixId": "pix-out-7781",
  "status": "PENDING",
  "amount": 25000,
  "key": "11999990000"
}
```
销售交易首页
GET /v1/merchants/{document}/sales/overview opendata
加载某个 CNPJ 的收款机 / TapTon / 付款链接销售首页，每笔销售带有 saleId、charge_id 和 cardLastDigits，供筛选栏使用。
认证方式：登录商户账户时签发的 Bearer 会话令牌，登录后的每次调用都会附带。
- document
- stoneCode
- sales
- saleId
- charge_id
- cardLastDigits
- amount
- status
```
GET /v1/merchants/12345678000190/sales/overview HTTP/1.1
Authorization: Bearer <access_token>
```
```
{
  "document": "12345678000190",
  "stoneCode": "123456789",
  "sales": [
    {
      "saleId": "sale-10021",
      "charge_id": "chg-10021",
      "cardLastDigits": "4421",
      "amount": 8990,
      "status": "CAPTURED"
    }
  ]
}
```
销售交易详情
GET /v1/merchants/{document}/sales/{sale_id} opendata
返回一笔已完成扣款或待处理的销售，商户可据此发送收据（电子邮件 / 短信 / 链接），或重试 / 重新处理这笔扣款。
认证方式：登录商户账户时签发的 Bearer 会话令牌，登录后的每次调用都会附带。
- saleId
- charge_id
- transaction_id
- document
- stoneCode
- cardLastDigits
- amount
- status
```
GET /v1/merchants/12345678000190/sales/sale-10021 HTTP/1.1
Authorization: Bearer <access_token>
```
```
{
  "saleId": "sale-10021",
  "charge_id": "chg-10021",
  "transaction_id": "trx-10021",
  "document": "12345678000190",
  "stoneCode": "123456789",
  "cardLastDigits": "4421",
  "amount": 8990,
  "status": "CAPTURED"
}
```
应收款汇总
GET /v1/merchants/{document}/settlements/summary opendata
返回本月已结算的刷卡应收款与尚未到账的 futureReceivables，供首页组件和预支模拟器使用。
认证方式：登录商户账户时签发的 Bearer 会话令牌，登录后的每次调用都会附带。
- status
- paidMonthly
- futureReceivables
- title
- amount
```
GET /v1/merchants/12345678000190/settlements/summary HTTP/1.1
Authorization: Bearer <access_token>
```
```
{
  "status": "success",
  "paidMonthly": {
    "title": "Recebido no mês",
    "amount": {"text": "R$ 48.200,00"}
  },
  "futureReceivables": {
    "title": "A receber",
    "amount": {"text": "R$ 19.350,00"}
  }
}
```
应收款合约汇总
GET /v1/merchants/{document}/settlements/agreements opendata
列出某个 CNPJ 的应收款日程（agenda de recebíveis）合约，包含用于对被占用合约提出异议的 contractKey。
认证方式：登录商户账户时签发的 Bearer 会话令牌，登录后的每次调用都会附带。
- document
- contracts
- contractKey
- stoneCode
- status
```
GET /v1/merchants/12345678000190/settlements/agreements HTTP/1.1
Authorization: Bearer <access_token>
```
```
{
  "document": "12345678000190",
  "contracts": [
    {
      "contractKey": "ctr-stone-01",
      "stoneCode": "123456789",
      "status": "ACTIVE"
    }
  ]
}
```

Open Finance 已授权账户

GET /v1/linked-banks/accounts openfinance

返回商户同意通过 Open Finance TPP 共享到 Ton 的银行账户，附 ISPB 风格的分行 / compe 标识符和最新的 availableAmount。

认证方式：登录商户账户时签发的 Bearer 会话令牌，登录后的每次调用都会附带。

accountId
balance
availableAmount
updatedAt
updatedAtOrigin
branchCode
checkDigit
companyCnpj
compeCode
number
organisationId
organizationName
type

GET /v1/linked-banks/accounts HTTP/1.1
Authorization: Bearer <access_token>

{
  "accountId": "of-acc-55",
  "balance": {
    "availableAmount": {"amount": 320045, "currency": "BRL"},
    "updatedAt": "2026-10-17T11:02:01Z",
    "updatedAtOrigin": "2026-10-17T11:01:40Z"
  },
  "branchCode": "0001",
  "checkDigit": "7",
  "companyCnpj": "00000000000191",
  "compeCode": "260",
  "number": "12345678",
  "organisationId": "bank-example",
  "organizationName": "Banco Exemplo S.A.",
  "type": "CACC",
  "updatedAt": "2026-10-17T11:02:01Z"
}

Open Finance 账户交易

GET /v1/linked-banks/entries openfinance

分页返回已授权银行的对账单，供 Ton 的 Open Finance 首页使用，每行带有交易对手的 CPF/CNPJ 和 creditDebitType。

认证方式：登录商户账户时签发的 Bearer 会话令牌，登录后的每次调用都会附带。

data
hasNext
nextCursor
pageSize
accountId
transactionId
amount
currency
creditDebitType
type
transactionName
partieCnpjCpf
partiePersonType
consentId
transactionDate

GET /v1/linked-banks/entries?accountId=of-acc-55&pageSize=20 HTTP/1.1
Authorization: Bearer <access_token>

{
  "data": [
    {
      "accountId": "of-acc-55",
      "transactionId": "of-txn-901",
      "amount": {"amount": 15000, "currency": "BRL"},
      "currency": "BRL",
      "creditDebitType": "CREDIT",
      "type": "PIX",
      "transactionName": "Pix recebido",
      "partieCnpjCpf": "11122233344",
      "partiePersonType": "NATURAL_PERSON",
      "consentId": "urn:example:consent:aa11",
      "transactionDate": "2026-10-16"
    }
  ],
  "hasNext": false,
  "nextCursor": null,
  "pageSize": 20
}

列出 Stone 银行卡
GET /v1/cards openbanking
列出 Ton 钱包中的借记、信用和预付费虚拟 / 实体卡，商户可对某个 card_id 执行冻结、解冻或补发。
认证方式：登录商户账户时签发的 Bearer 会话令牌，登录后的每次调用都会附带。
- cards
- card_id
- cardLastDigits
- status
```
GET /v1/cards HTTP/1.1
Authorization: Bearer <access_token>
```
```
{
  "cards": [
    {
      "card_id": "card-778",
      "cardLastDigits": "4421",
      "status": "ACTIVE"
    }
  ]
}
```
商户开户资料
GET /v1/merchants/profiles/{stone_account_id} osint
读取某个 Stone 账户的 KYC / 开户资料（document、stoneCode、MCC），供商户资料和待更新界面使用。
认证方式：登录商户账户时签发的 Bearer 会话令牌，登录后的每次调用都会附带。
- stone_account_id
- document
- stoneCode
- mcc
```
GET /v1/merchants/profiles/sa-197-8841 HTTP/1.1
Authorization: Bearer <access_token>
```
```
{
  "stone_account_id": "sa-197-8841",
  "document": "12345678000190",
  "stoneCode": "123456789",
  "mcc": "5411"
}
```

数据类别

余额
交易
Pix
应收款
银行卡
Open Finance
商户档案

数据使用场景与案例

ERP 柜台对账
夜间任务拉取交易首页的 saleId、charge_id、cardLastDigits 和 amount，再与 conta 的 availableAmount 比对，让店铺的 ERP 无需从应用导出 CSV 就能完成日结。
基于应收款的授信评估
放款机构读取 paidMonthly 与 futureReceivables，以及 contracts/summary 中的 contractKey 列表，按 Stone 的应收款日程（agenda de recebíveis）评估营运资金额度，而不是依赖通用的征信报告。
Pix 结账自动化
店铺前端提交静态 Pix 二维码请求，带上 key、amount 和 transactionId，再把 qrCodeContent 存下来交给顾客；isSalesKey 则告诉柜台哪个 chave 是默认的收款机密钥。
多银行 Open Finance 看板
现金流工具列出已授权账户（accountId、compeCode、availableAmount）并分页读取对账单条目（transactionId、creditDebitType、partieCnpjCpf），让商户在同一本账里看到 Nu、Stone 和其他 ISPB 的账户。

常见问题

Ton 开放了哪些商户数据？

登录后的会话会返回数字账户余额（availableAmount、label、value）、Pix 密钥（key、keyType、isSalesKey）、收款机销售（saleId、charge_id、cardLastDigits）、应收款（paidMonthly、futureReceivables、contractKey）以及 Open Finance 已授权账户（accountId、compeCode、partieCnpjCpf）。

Ton 如何认证 API 调用？

登录之后的调用会附带由 Stone 商户登录服务签发的 Bearer 会话令牌。余额、Pix、销售和 Open Finance 都不允许匿名访问。

Ton 只有收款机，还是也包含 Open Finance？

也包含。作为 TPP，它会列出已授权的外部账户并分页读取其对账单；作为持有账户的机构，它还支持商户自有 conta 的支付授权（payment-consent）和共享授权（share-consent）流程。

与 Ton: maquininha, tap e conta 相似的应用

InfinitePay Tap, Conta, Cartão — CloudWalk 的 InfinitePay 把带 NFC 的手机变成免费 InfiniteTap 收银，面向巴西 CNPJ、CPF 和 MEI 卖家，并配免费数字账户、0% Pix、付款链接和可选 Smart POS。
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 把智能手机变成非接触收银，并与 Point 刷卡机、Pix 二维码和 Mercado Pago 数字账户一起用于巴西当面收款。
Cielo Tap — Cielo Tap 内置于 Cielo Gestão 应用，可在手机上感应收借记、贷记和钱包且无月费，并与 Cielo Flash、Smart 终端以及即时 Pix 并列。
SumUp — 巴西 SumUp 让卖家免额外硬件用手机感应收款，也可配实体刷卡机，并经由 SumUp 数字账户收发 0% 费率的 Pix。
Getnet Get Tap — Getnet 的 Get Tap 把智能手机变成收银机，可收借记、最长 12 期贷记和 Pix，并配 Get Mini、Smart 终端以及两个工作日结算的免费 Get Conta。

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

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

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

获取报价

Ton 商户数据 API：余额、Pix、销售与 Open Finance

应用截图

API 端点一览

读取数字账户余额

列出商户账户

列出 Pix 密钥

创建静态 Pix 二维码

发起转出 Pix

销售交易首页

销售交易详情

应收款汇总

应收款合约汇总

Open Finance 已授权账户

Open Finance 账户交易

列出 Stone 银行卡

商户开户资料

数据类别

数据使用场景与案例

ERP 柜台对账

基于应收款的授信评估

Pix 结账自动化

多银行 Open Finance 看板

常见问题

与 Ton: maquininha, tap e conta 相似的应用

更多支付类应用

BharatPe for Business

BrasilCard Cliente

BukuWarung Apps for MSMEs

CashBook - Balance & Expense

相关主题

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

Ton 商户数据 API：余额、Pix、销售与 Open Finance

应用截图

API 端点一览

读取数字账户余额

列出商户账户

列出 Pix 密钥

创建静态 Pix 二维码

发起转出 Pix

销售交易首页

销售交易详情

应收款汇总

应收款合约汇总

Open Finance 已授权账户

Open Finance 账户交易

列出 Stone 银行卡

商户开户资料

数据类别

数据使用场景与案例

ERP 柜台对账

基于应收款的授信评估

Pix 结账自动化

多银行 Open Finance 看板

常见问题

相关应用

与 Ton: maquininha, tap e conta 相似的应用

更多支付类应用

BharatPe for Business

BrasilCard Cliente

BukuWarung Apps for MSMEs

CashBook - Balance & Expense

相关主题

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