这页写给为 Developer 组织付款或对账的人。它说明怎样为一项活动Developer 组织的一组数据工作及其相关设置准备资金,怎样看清它预留和花掉了多少,以及到哪里取得单据。这里的每个金额都属于当前 OrganizationDeveloper 侧管理活动、数据访问和组织资金的单位。
打开 Billing
点击 Developer 左下角的账户菜单,选择 Billing & Wallet(账单与钱包)。打开的页面标题是 Billing(账单)。
页面显示的是菜单中当前 Organization 的资金。你属于多个组织时,先切换到要查看的那一个,再读数字或付款。
Billing 有四个视图:
| 视图 | 在这里做什么 |
|---|---|
| Balances(余额) | 查看组织的 USD 和 USDC 余额,发起 Add USD(充值 USD),打开 Manage USDC(管理 USDC) |
| Activity(账户动态) | 逐笔查看本 UTC 自然月的交易:充值、预留、用量扣费、转换和退款 |
| Documents(票据) | 下载月度对账单和每笔付款的收据 |
| Earnings(收益) | 查看发布方收入,也就是组织发布的数据资产和 Agent 带来的收入。它与充值用于支出的 USD 分开存放,与活动的资金准备无关 |
原来的 Wallet 页已并入 Balances,旧的 Wallet 书签会打开 Billing。
两个余额怎么读
Balances 里有两张卡片:USD balance(USD 余额)和 USDC balance(USDC 余额)。两者分开存放,页面从不把它们相加。
| 数字 | 含义 | 怎么用 |
|---|---|---|
| Available to use(可用余额) | 现在可以支出、预留或转换的 USD | 发布活动前,拿它和预算比较 |
| Reserved for campaigns(为活动预留) | 为运行中或已暂停的活动留出的 USD | 它是已承诺的钱,还没有花掉。活动结束后,未用完的部分回到可用余额 |
| Held for disputes(争议冻结) | 银行卡付款处于争议期间被冻结的 USD。只有存在这类金额时才显示这一行 | 等待争议结果。结果对你有利时,这笔钱回到可用余额 |
| Total USD funds(USD 资金合计) | 以上各行 USD 的总和,不含 USDC 和发布方收入 | 用来确认以上各行没有漏掉任何一笔 USD |
| Available USDC(可用 USDC) | 组织存放在平台上的 USDC。它只有一个数字,没有预留部分 | 判断能否发布时可以略过它,发布不会动用 USDC |
USD 的几个数字由一个等式连在一起:
Total USD funds = Available to use + Reserved for campaigns + Held for disputes
卡片上没有 Held for disputes 这一行时,这个金额为零。
USD 在这几行之间移动时,合计不变。只有 USD 进入或离开组织的余额时,合计才会变化。
| 发生了什么 | Available to use | Reserved for campaigns | Total USD funds |
|---|---|---|---|
| 你充值 USD | 增加 | 不变 | 增加 |
| 发布活动,或增加它的预算 | 减少 | 增加 | 不变 |
| 一份被接受的 Submission 完成结算 | 不变 | 减少 | 减少 |
| 活动结束,预算还有剩余 | 增加 | 减少 | 不变 |
| 数据访问或 Agent 调用被扣费 | 减少 | 不变 | 减少 |
| 你把 USD 换成 USDC | 减少 | 不变 | 减少 |
卡片提示余额无法加载时,这个数字是未知而非零,刷新后再决定是否付款。还没有计费账户的组织看到的是一条说明,第一次 Add USD 会开通这个账户。
USDC 是什么,由谁来转换
USDC 是一种数字美元:它是与美元挂钩的代币,1 USDC 的价值设计为等于 1 USD。它发到数字钱包,而不是银行账户,Contributor 就是这样收到报酬的。为活动准备资金时,你不需要自己的钱包,也不需要了解加密货币。
Humanbased 用 USDC 向 Contributor 付款,你用 USD 付款。一份被接受的 Submission一次提交形成的结果记录 结算时,Humanbased 从 Reserved for campaigns 中按 USD 扣除它的费用,再把报酬以 USDC 记给 Contributor。这次转换是结算的一部分,由 Humanbased 完成。
因此,活动在发布时、支付工作时和结束时都不会动用 Available USDC。为活动提供资金的只有 USD 余额。
Manage USDC 是另一项可选操作,大多数组织用不到它。它把你自己的 USD 换成 USDC,由组织存放在平台上。操作步骤见下文“把 USD 换成 USDC”一节。
发布前,先判断要补哪一笔钱
发布活动时,平台预留的是 USD:金额等于这项活动的整笔预算上限,从 Available to use 中划出。USDC 余额不计入。
所以发布前只需要做一次比较:
- 打开草稿的 Test & Launch(试跑与启动)阶段,进入 Pricing & Budget(定价与预算)步骤。Budget cap (USD)(预算上限(美元))就是发布时要预留的金额。
- 在 Billing 打开 Balances,读 Available to use。
- 可用余额小于预算上限时,差额就是缺口。用 Add USD 至少补足这个差额。
发布前无需把资金换成 USDC。转换会减少 Available to use,而且门户没有把 USDC 换回 USD 的入口。
门户在 Launch(上线)步骤做同一次比较。摘要列出 Budget cap(预算上限)和 Wallet balance(钱包余额),这里的 Wallet balance 就是 Available to use。它低于预算上限时,页面提示 “Wallet balance is below the $500 budget cap. Top up before launching.”,其中的金额是你自己的预算上限。这时 Promote & Lock(发布并锁定预算)按钮保持不可用。发布时服务端还会再核一次,余额不足的发布不会预留任何资金。
示意:一项活动的预算上限是 500 USD。
| 时刻 | Available to use | Reserved for campaigns | Available USDC |
|---|---|---|---|
| 充值前 | 300.00 USD | 0.00 USD | 150.00 USDC |
| 用 Add USD 充值 200.00 后 | 500.00 USD | 0.00 USD | 150.00 USDC |
| 发布后 | 0.00 USD | 500.00 USD | 150.00 USDC |
缺口是 200 USD。那 150 USDC 抵不了缺口;如果把 300 USD 中的一部分换成 USDC,缺口只会更大。
用 Add USD 充值
组织的任何成员都可以充值。无论谁付款,款项都计入组织的 USD 余额。
- 在 Balances 选择 Add USD。充值流程会占据整个 Billing 页面,并写明这次为哪个组织充值。
- 在 Amount & billing(金额与开票)选择预设金额,或在 Amount · USD(金额 · 美元)填写自定金额,最低 1.00 USD。
- 在 Who should we bill?(账单开给谁)选择收据上显示的法律主体。无论选哪个主体,资金都进入当前组织。然后选择 Continue to payment(继续付款)。
- 在 Payment method(付款方式)中,可用的方式是在 Stripe 的页面用银行卡付款。选择 Review top-up(确认充值)。
- 在 Review & pay(确认并支付)核对 Credit to(入账至)、USD to add(充值金额)和 Bill to(开票给)。Fees and tax(手续费与税费)由 Stripe 在结账页计算。
- 选择带金额的 Pay(付款)按钮,进入 Stripe 付款页并完成付款。Stripe 会把你带回 Billing,页面向服务端查询这笔付款的结果。
随后页面显示以下结果之一:
| 页面显示 | 含义 | 你现在做什么 |
|---|---|---|
| 标题以 USD added(已入账)结尾 | 款项已确认计入组织的 USD 余额 | 用 View payment receipt(查看付款收据)保存收据,再选 Done(完成) |
| Payment received. Confirming your credit.(已收到付款,正在确认入账) | 付款成功,余额还没有更新 | 选择 Check status(查询状态)。这时再付一次可能造成重复扣款 |
| Your payment is still being confirmed(这笔付款仍在确认中) | 暂时无法确定最终结果 | 记下 Payment reference(付款单号),稍后再用 Check status 查询。到第二天仍未确认时,把单号发给 hello@humanbased.ai |
| Payment not completed(付款尚未完成) | 你在付款完成前离开了付款页 | 选择 Go back to the payment(返回该笔付款),继续的是同一笔付款 |
| Approve the payment with your bank(请在银行侧确认这笔付款) | 银行要先验证这笔银行卡付款 | 选择 Return to the payment page(返回支付页面)完成验证 |
| Your card wasn't charged(未对你的银行卡扣款) | 付款没有成功,或付款页在完成前已过期 | 如果付款页打开后隔了很久才回来,它已经过期,与银行无关:直接选 Try again(重新支付)发起新的付款。其他情况先与银行确认或换一张卡,再选 Try again |
付款确认后,Activity 中会出现一条 Funds added(充值入账)记录,收据列在 Documents 的 Payment receipts(付款收据)下。
把 USD 换成 USDC
活动直接使用 USD。只有确实需要 USDC 时才转换:
- 在 USDC balance 卡片选择 Manage USDC。
- 在 Amount · USD 填写金额:大于零,最多两位小数。只能转换 Available to use 中的 USD,已预留的部分排除在外;超出这个数的金额在报价之前就会被拒绝。
- 选择 Review conversion(确认转换详情),查看汇率、费用、USDC you receive(你将收到的 USDC)以及转换后的两个余额。选 Change amount(修改金额)可回去改金额。
- 在五分钟内选择 Confirm conversion(确认转换),窗口会为报价倒计时。完成页给出 Reference(凭证号)和转换后的两个余额。
五分钟用完后,Confirm conversion 会换成 Get a new quote(重新获取报价),按同一金额重新报价,汇率可能已经变化。如果确认失败,窗口会说明没有发生任何转换,并提供 Try again(重试)。如果只是回复在途中丢失,转换可能已经完成。重试发出的是同一个请求,所以只会取回那次转换,不会再转换一次。新报价则是一个新请求:确认失败后,先在 Available USDC 和 Activity 里查看有没有一笔你没看到完成的转换,再确认新报价。
转换只有一个方向。同一窗口里的 USDC → USD(把 USDC 换回 USD)和 Withdraw to a bank account(提现到银行账户)显示为锁定,两项都无法使用。
活动预算:设置与增加
草稿阶段,在 Pricing & Budget 步骤填写 Budget cap (USD)。同一步骤列出每个人工步骤的报酬;要改报酬,回到 Builder 中对应的人工步骤。适用平台服务费时,页面把它单独列为一行,加在报酬之上,预算需要同时覆盖两者。正式发布时预留整笔预算上限,发布页把这一步称为锁定预算。
活动运行后,打开 Setup(配置)中的 Budget & costs(预算与成本)。Overview(概览)里的 Increase budget(追加预算)通向同一处。
- 在 Total budget(总预算)旁读 Wallet available(钱包可用),它就是组织的 Available to use。
- 在 Budget (USD)(预算(USD))填写新的总预算,它必须高于当前预算。
- 选择 Increase budget。平台只预留新旧预算之间的差额。
可用余额小于这个差额时,增加会被拒绝,也不会预留任何资金。先用 Add USD 补足差额,再保存。
发布后预算只增不减,活动运行或暂停期间,预留一直留在这项活动上。预留的钱不够支付下一份工作时,活动会自动暂停。要继续工作,先增加预算,再选择 Resume(恢复);在此之前活动一直保持暂停。结束的活动完成收尾后,未用完的预留回到 Available to use。暂停与收尾见测试、发布与运行状态。
核对一项活动的资金
一项活动的钱会移动三次:发布时预留,工作被接受时支出,结束时退回剩余部分。Activity 把每次移动记为一行,每一行在名称下方标出类型。
| Activity 中的类型和状态 | 发生了什么 | 怎么算 |
|---|---|---|
| Campaign reservation(活动预留),状态 Reserved(已预留)。金额为负,并标注 Moved to reserved(已划入预留) | 发布或增加预算时,USD 从可用余额划入预留 | 算作留出的预算。它还不是支出 |
| Reservation released(预留释放),状态 Settled(已结算),金额为负 | 一份被接受的 Submission 完成结算,它的费用从预留中支出:Contributor 报酬加平台服务费,以 USD 计。可用余额不变 | 这就是活动的实际支出,把这些行加起来 |
| Refund(退款),状态 Settled,金额为正,名称以 “Refund from locked balance” 开头 | 活动结束,未用完的预留退回可用余额 | 算作预算退回,不算收入 |
因此 Reserved for campaigns 会在三种情况下变化:发布或增加预算时增加,Submission 结算时减少,活动结束时再减少。只有中间一种是支出。
把这些记录连起来的标识是 Campaign ID,也就是门户里这项活动地址中 /campaigns/ 后面的那一段。预留记录和单笔结算记录的名称里都带有它。退回记录的详情中,Reference(关联编号)写作 close: 加 Campaign ID。导出文件用 campaign_id 一列记录它。
汇总一项活动:
- 从活动的地址复制 Campaign ID。
- 在 Billing 打开 Activity,筛选器保持 All activity(全部活动),再选择 Export all CSV(导出全部 CSV)。文件逐笔列出本 UTC 自然月至今的全部交易;活动跨月运行时,在每个月结束前导出一次。
- 只保留
campaign_id等于这项活动的行。 - 按
type分别合计amount:lock是预留,release是支出,refund是退回。
在页面上也可以分开查看这三类记录:把同一个筛选器改选为 Reservations(预留)、Usage charges(用量扣费)或 Refunds(退款)。Grouped(合并)模式下,同一项活动在同一个 UTC 日的多笔结算合成一行,以活动名称显示并标注 Daily total(当日合计)。展开后是同一批交易的逐笔明细,合并行和明细只计其一。要找某一份 Submission 的费用,把 Submission ID 粘贴到搜索框。
示意(续):这项 500 USD 的活动接受了共 300 USD 的工作,随后结束。
| Activity 记录 | 金额 | Available to use | Reserved for campaigns |
|---|---|---|---|
| Campaign reservation | -500.00 USD | 0.00 USD | 500.00 USD |
| Reservation released,全部合计 | -300.00 USD | 0.00 USD | 200.00 USD |
| Refund | +200.00 USD | 200.00 USD | 0.00 USD |
这项活动的支出是 300 USD。如果把预留和结算两类金额相加,会得出 800 USD,超过了它 500 USD 的预算。
不要用单项活动的预算去减组织级的数字。Activity 顶部的 Usage charges 合计和 Balances 上的余额,包含组织内所有活动、数据访问扣费和 Agent 调用。要看单项活动的现状,打开它的 Overview,读 Budget & obligations(预算与义务)。其中的 Campaign funds held(活动托管资金)、Outstanding obligations(未结清义务)和 Available for new work(可用于新工作)只针对这一项活动。
谁可以做什么
Billing 只核对你是否是这个 Organization 的成员,组织角色不影响结果。把资金投入某项活动则另行核对你在该活动上的角色。
| 操作 | 谁可以做 | 做不了时 |
|---|---|---|
| 打开 Billing,查看 Balances、Activity 和 Documents;导出 CSV;下载对账单和收据 | 组织的任何成员 | 请组织的 Owner 或 Admin 把你加入组织 |
| Add USD | 组织的任何成员 | 同上 |
| 在 Manage USDC 中把 USD 换成 USDC | 组织的任何成员 | 同上 |
| 发布活动,同时预留预算 | 活动 owner | 发布被拒绝,也不会预留资金。请活动 owner 发布 |
| 对运行中的活动使用 Increase budget | 活动 owner | 保存被拒绝,预算保持原样。请活动 owner 修改 |
活动 owner 指创建这项活动的人,以及所属组织的 Owner 和 Admin。组织的其他成员在这项活动上的角色低于 owner,发布和调整预算都需要 owner 来做。活动自身的成员名单里为你登记了角色时,以登记的角色为准。
所以,能在 Billing 里看到全部数字的同事,未必能发布活动或增加预算。组织角色在 Organization 的 Members(成员)中查看。活动自己的成员列在它的 Setup 下的 Team & access(团队与权限)。
费用、收据与对账单
在活动的 Budget & costs 中,Cost breakdown(成本明细)分别列出 Actual cost(实际成本)、Platform fee(平台服务费)和 Total / record(每条合计),并显示账户的费用层级。按这条记录显示的费率核对,历史条目的费率只适用于它自己。页面写 Platform fee (20% of total) 时,20% 的基数是总额。Contributor 报酬为 1 USDC 时,总额为 1 ÷ (1 − 20%) = 1.25 USDC,其中平台费用 0.25 USDC。这是该口径的算法示例,每条记录适用的费率就是它旁边显示的那一个。
Documents 提供两类单据:
- Payment receipts 逐笔列出付款的日期和金额。View receipt(查看收据)打开预览,Download PDF(下载 PDF)保存文件。一张收据确认一笔付款。
- 对账单表格按自然年列出各月。当前月标为 In progress — draft(进行中——草稿),提供 Generate PDF(生成 PDF)。已结束的月份标为 Available(可下载),提供 Download PDF。需要比列表更早的月份时,在表格下方的月份输入框选定月份,再选 Get statement(获取对账单)。
对账单列出期初和期末余额、充值、合并后的用量、退款和转换,USD 与 USDC 分开显示。已结束月份的对账单只出具一次,之后保持不变;当前月的是截至目前的草稿。Download underlying transactions as CSV(下载明细交易 CSV)给出当前月对账单背后的逐笔交易。
仍有无法解释的差异时,向支持团队提供组织、月份、Transaction ID(交易 ID)、类型和 Campaign ID。银行卡完整资料和访问凭据请留在自己手里。