> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thedecard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 资金与对账 · 概述

> 为公司资金池与独立余额卡充值、池⇄卡划拨、查余额，以及三层对账：充值流水、交易流水与账单。

## 📄 正文

资金侧只有一个原则：先充值、后消费。本页按「入金 → 划拨 → 查余额 → 对账」的顺序讲清资金接口；资金主体（owner）概念见[持卡主体与资金模型](../basic-concepts/identity-and-funding)。

## 充值入金

**① 取收款账户**：`GET /open-api-corp/fund/v1/deposit-info?subjectType=...&subjectId=...&currency=...`——返回该资金主体（`ORGANIZATION` 公司池 / `CARD` 独立余额卡）该币种的收款 VA 信息：`payeeAccountNumber`、`payeeBankCode` / `payeeBankName`、`payeeAccountName`、`payeeSwiftCode`（跨境电汇必填）、银行与收款人地址，以及 `remark`（转账附言要求）。

**② 客户银行转账**：客户按上述信息电汇 / 转账至 VA。

**③ 到账通知**：入金到账推送 Webhook `BANK_TRANSFER_INFO`（成功 / 失败由 `status` 区分，携 `depositId` / `amount` / `currency` / 付款方信息）。

## 池 ⇄ 卡划拨

`POST /open-api-corp/fund/v1/transfer`——公司资金池与独立余额卡之间的内部划拨，**同币种、不换汇、同公司闭环**：COMPANY→CARD 为给卡充值（下拨预算），CARD→COMPANY 为回收余额。

| 字段                                    | 必填 | 说明                                                |
| ------------------------------------- | -- | ------------------------------------------------- |
| `transferRef`                         | 是  | ≤64；划拨幂等键，重复提交返回 `TRANSFER_DUPLICATE`             |
| `organizationId`                      | 是  | 划拨闭环边界，双方须同属该公司                                   |
| `from.subjectType` / `from.subjectId` | 是  | `ORGANIZATION`→`organizationId` / `CARD`→`cardId` |
| `to.subjectType` / `to.subjectId`     | 是  | 须与 `from` 端类型相异——两端恒为一个 `ORGANIZATION` 一个 `CARD`  |
| `amount` + `currency`                 | 是  | 金额 >0、≤2 位小数；币种须与双方账户一致（`CURRENCY_MISMATCH`）      |

响应 `status` 为 `SUCCESS` / `PROCESSING` / `FAILED`；**返回 `PROCESSING` 时必须用 `GET /fund/v1/transfer-query?transferRef=...` 轮询确认最终结果**。SHARED 卡不持有余额、不可作为划拨端点（`CARD_NOT_DEDICATED`）；转出方余额不足返回 `INSUFFICIENT_FUNDS`。

## 查余额

`GET /open-api-corp/fund/v1/balance?subjectType=...&subjectId=...`——按资金主体查各币种余额，每币种返回 `availableAmount`(当前可用余额)。余额实时作为授权闸门。

## 三层对账

| 层    | 接口                                                   | 用途                                                                |
| ---- | ---------------------------------------------------- | ----------------------------------------------------------------- |
| 充值流水 | `GET /fund/v1/deposit-records`                       | 分页查 VA 入金历史（可按 owner / 币种 / 到账时间过滤），与银行水单核对                       |
| 交易流水 | `POST /statement/v1/transactions`                    | 按时间区间查交易（不受账期限制，**窗口不超过半年**）；`cardId` 不传为公司维度、传则收窄到该卡（含该卡 VA 的充值） |
| 账单   | `POST /statement/v1/statements` + `statement-detail` | 账单级对账，见下                                                          |

**交易流水关键字段**：`transactionCategory`（`PURCHASE` / `REFUND` / `FEE` / `REPAYMENT` / `CASH_ADVANCE` / `DEPOSIT` / `TRANSFER`）、`postStatus`（`POSTED` 已入账 / `UNPOSTED` 授权占用中 / null 还款类无此语义）、原始与入账两组金额币种（`originalAmount`/`originalCurrency`、`postAmount`/`postCurrency`）、`postTime`（授权占用中为 null）、`merchant`（含 `merchantName` / `mcc` / `merchantCountryCode`）。

**账单列表**：`POST /statement/v1/statements`——按公司（`type=SHARED`）或按卡（`type=DEDICATED`，`cardId` 必填）查指定区间账单，账期倒序。每期账单返回 `statementId`（未出账单为 null）、`statementPeriod`、`status`（`OPEN` / `SETTLED`）、`statementDate` / `paymentDueDate`、`paymentStatus`（`CURRENT` / `AWAITING_PAYMENT` / `PAID` / `OVERDUE`，实时计算）与按币种的 `summary`（消费 / 退款 / 费用 / 还款 / 取现 / 到期应还 / 溢缴款等合计）。

**账单详情**：`POST /statement/v1/statement-detail`——账单头 + 按币种汇总 + 交易明细（分页仅作用于明细）。查**已出账单**传 `statementId`；查**当前未出账单**传 `statementId=null` + `status=OPEN`。

<Note>
  **以已出账单为最终口径**：未出账单（OPEN）是当前账期的实时汇总,包含尚未清算的授权占用,消费合计会随清算回落,属预期行为。账单机制与关键日期见[限额与账单](../basic-concepts/limits-and-billing)。
</Note>

## 关联 Webhook

`BANK_TRANSFER_INFO`（VA 入金到账）/ 余额变动通知 / `LOW_BALANCE`（资金池低余额预警,配置见[管理公司](./managing-companies)）。

## 下一步

* 欠款如何产生与通知：[交易授权与 3DS](./authorization-and-3ds)
* 账期、已出/未出账单的口径：[限额与账单](../basic-concepts/limits-and-billing)
* 本组详页：[充值入金](./deposits) · [余额与划拨](./balances-and-transfers) · [账单与交易查询](./statements-and-transactions)