Skip to main content

📄 正文

资金侧只有一个原则:先充值、后消费。本页按「入金 → 划拨 → 查余额 → 对账」的顺序讲清资金接口;资金主体(owner)概念见持卡主体与资金模型

充值入金

① 取收款账户GET /open-api-corp/fund/v1/deposit-info?subjectType=...&subjectId=...&currency=...——返回该资金主体(ORGANIZATION 公司池 / CARD 独立余额卡)该币种的收款 VA 信息:payeeAccountNumberpayeeBankCode / payeeBankNamepayeeAccountNamepayeeSwiftCode(跨境电汇必填)、银行与收款人地址,以及 remark(转账附言要求)。 ② 客户银行转账:客户按上述信息电汇 / 转账至 VA。 ③ 到账通知:入金到账推送 Webhook BANK_TRANSFER_INFO(成功 / 失败由 status 区分,携 depositId / amount / currency / 付款方信息)。

池 ⇄ 卡划拨

POST /open-api-corp/fund/v1/transfer——公司资金池与独立余额卡之间的内部划拨,同币种、不换汇、同公司闭环:COMPANY→CARD 为给卡充值(下拨预算),CARD→COMPANY 为回收余额。 响应 statusSUCCESS / 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(当前可用余额)。余额实时作为授权闸门。

三层对账

交易流水关键字段transactionCategoryPURCHASE / REFUND / FEE / REPAYMENT / CASH_ADVANCE / DEPOSIT / TRANSFER)、postStatusPOSTED 已入账 / UNPOSTED 授权占用中 / null 还款类无此语义)、原始与入账两组金额币种(originalAmount/originalCurrencypostAmount/postCurrency)、postTime(授权占用中为 null)、merchant(含 merchantName / mcc / merchantCountryCode)。 账单列表POST /statement/v1/statements——按公司(type=SHARED)或按卡(type=DEDICATEDcardId 必填)查指定区间账单,账期倒序。每期账单返回 statementId(未出账单为 null)、statementPeriodstatusOPEN / SETTLED)、statementDate / paymentDueDatepaymentStatusCURRENT / AWAITING_PAYMENT / PAID / OVERDUE,实时计算)与按币种的 summary(消费 / 退款 / 费用 / 还款 / 取现 / 到期应还 / 溢缴款等合计)。 账单详情POST /statement/v1/statement-detail——账单头 + 按币种汇总 + 交易明细(分页仅作用于明细)。查已出账单statementId;查当前未出账单statementId=null + status=OPEN
以已出账单为最终口径:未出账单(OPEN)是当前账期的实时汇总,包含尚未清算的授权占用,消费合计会随清算回落,属预期行为。账单机制与关键日期见限额与账单

关联 Webhook

BANK_TRANSFER_INFO(VA 入金到账)/ 余额变动通知 / LOW_BALANCE(资金池低余额预警,配置见管理公司)。

下一步