# 数字账户 (/zh/docs/conta-digital)

每个凭证只操作一个账户：没有任何路由接收 `accountId`。要操作两个账户，请使用两个凭证。

<QuickLinks>
  <QuickLink href="/docs/conta-digital/getting-started" title="快速开始" />

  <QuickLink href="/docs/conta-digital/authentication" title="身份认证" />

  <QuickLink href="/docs/conta-digital/endpoints" title="API 参考" />

  <QuickLink href="/docs/conta-digital/webhooks" title="Webhooks" />

  <QuickLink href="/docs/conta-digital/error-codes" title="错误代码" />

  <QuickLink href="/docs/conta-digital/for-ai" title="面向 AI" />
</QuickLinks>

<Mermaid
  chart="`
flowchart LR
  Loja[&#x22;你的应用&#x22;] -->|&#x22;凭证&#x22;| API[&#x22;数字账户 API&#x22;]
  API --> CB[&#x22;Pix 收款&#x22;]
  API --> SQ[&#x22;提现与 Pix 复制粘贴码付款&#x22;]
  API --> TR[&#x22;账户间转账&#x22;]
  API --> EX[&#x22;余额与账单&#x22;]
  API -.->|&#x22;Webhook&#x22;| Loja

  click CB &#x22;/docs/conta-digital/charges&#x22; &#x22;收款&#x22;
  click SQ &#x22;/docs/conta-digital/withdrawals&#x22; &#x22;提现&#x22;
  click TR &#x22;/docs/conta-digital/internal-transfers&#x22; &#x22;转账&#x22;
  click EX &#x22;/docs/conta-digital/statement&#x22; &#x22;账单&#x22;

  style API fill:#14ce71,stroke:#0eb464,color:#ffffff
`"
/>

## 从哪里开始 [#从哪里开始]

| 如果你想          | 从这里开始                                                                                       |
| ------------- | ------------------------------------------------------------------------------------------- |
| **发起第一次调用**   | [快速开始](/docs/conta-digital/getting-started) → [身份认证](/docs/conta-digital/authentication)    |
| **通过 Pix 收款** | [Pix 收款](/docs/conta-digital/charges)                                                       |
| **向他人付款**     | [Pix 提现](/docs/conta-digital/withdrawals) 或 [支付 Pix 复制粘贴码](/docs/conta-digital/qr-payments) |
| **在店铺之间转移余额** | [账户间转账](/docs/conta-digital/internal-transfers)                                             |
| **对账**        | [余额、账单与限额](/docs/conta-digital/statement)                                                   |
| **跟踪每一次变化**   | [Webhooks](/docs/conta-digital/webhooks)                                                    |
| **直接查看路由**    | [API 参考](/docs/conta-digital/endpoints)                                                     |

## 约定 [#约定]

| 项目       | 规则                                                                 |
| -------- | ------------------------------------------------------------------ |
| Base URL | `https://api.hub.payzu.com.br/api/v1`                              |
| 金额       | 整数，单位为分：`1500` 即 R$ 15,00。                                         |
| 百分比      | 以基点表示：`150` 即 1.5%。                                                |
| 日期       | UTC 时间的 ISO 8601，例如 `2026-10-05T14:32:05.123Z`。                    |
| 列表       | 按游标分页：把响应中的 `nextCursor` 放入下一次调用的 `cursor` 参数。最后一页不返回它。            |
| 错误       | `{ "message", "code", "details" }`。按 `code` 处理；`message` 是用于展示的文本。 |

## 余额何时变化 [#余额何时变化]

| 操作              | 余额变化的时间                                 |
| --------------- | --------------------------------------- |
| 收款              | 客户付款时。会收到 `PAYMENT_PAID` Webhook。       |
| 提现和 Pix 复制粘贴码付款 | 发起请求时：金额和手续费从可用余额中扣出。操作失败时退回。           |
| 账户间转账           | 立即：响应中已带有结果。                            |
| 无收款单的入账 Pix     | Pix 到账时。会收到 `DEPOSIT_RECEIVED` Webhook。 |
| 退款和退回存款         | 发起请求时：金额和手续费从可用余额中扣出。退款失败时退回。           |

## API 不涵盖的内容 [#api-不涵盖的内容]

* **Boleto 和银行卡。** API 不开具 boleto，也不进行银行卡收款。银行卡请见[银行卡 API](/docs/cartao)。
* **答复 MED 争议。** API 显示争议；答复在控制台中进行。
* **创建或更换凭证。** 由账户持有人在控制台 [hub.payzu.com.br](https://hub.payzu.com.br) 中完成。

## 帮助 [#帮助]

<QuickLinks>
  <QuickLink href="https://suporte.payzu.com.br/portal/pt-br/newticket?departmentId=1103699000000006907&layoutId=1103699000000074011" title="提交工单" />

  <QuickLink href="/" title="所有产品" />
</QuickLinks>