申请充值
为密钥所属项目的账户充值:金额以美元计,精确到分,最低 $20(按控制平面的默认启动设置),最高 $1,000,000。本调用返回时状态为 to_collect;收款后,按美元数折算为同等数量的点数,存入一笔 365 天后失效的额度。充值不会改变任何账户的套餐:在任何套餐上,余额都用于支付超出套餐包含额度的用量。带 Idempotency-Key 时,用相同的键和请求体再次调用,无论来自账户的哪个项目、隔了多久,都会返回它们创建的那次充值(当时的状态),不会再创建新的。在平台已登记纳税的地方收款时,税款会加到银行卡支付的金额上,点数按税前金额计:澳大利亚用户充值 $20,支付 $22,得到 20 点数(扣款的 tax;control/README.md,税)。在只面向企业销售的地方,不是企业的账户会被拒绝 (403 tax_region_business_only):所在地按其账单地址确定,没有账单地址时,按调用来源地址所在的国家确定 (--ip-country-file)。调用的来源地址会与充值记录一起保存,作为客户所在地的证据之一。所需权限范围:admin。
https://api.glac.ai/v1/billing/topups授权
请求头参数
请求体JSON必填
- start_nowoptionalboolean
true:账户要求在 14 天内立即提供所购服务(欧洲经济区或英国的消费者在这 14 天内可以撤回购买),并确认如果撤回,需要为已提供的部分付费,以及点数已全部用完的充值视为已全部提供、不能再撤回(具体措辞见GET /v1/billing/withdrawals的right.start_now)。作为当地消费者购买的账户(没有已核验或正在核验的税号,且账单地址在当地;没有账单地址时,按调用的来源地址判断)必须给出:不给出时返回 400start_now_required。无论在哪里给出,都会与购买记录一起保存:不给出时,撤回会退还全部已付金额(control/README.md,撤回)。
Returns
201
充值记录。
- failureobject | nullrequired
失败的情况;不是
failed时为 null。对账户从不说明原因(银行或 Stripe 给出的拒绝原因会帮助试用盗刷卡的人):card_declined,即“The card was declined.”(其银行卡被拒绝:被发卡行、被 Stripe,或者因为这张卡支付的账户已达上限),或payment_failed,即“The payment failed.”(其他任何情况:没有登记银行卡、付款页面到期未付、发票在 Stripe 被作废、连不上 Stripe 或 Stripe 拒绝了请求)。两种情况的处理方式相同:在付款页面付款 (POST /v1/billing/checkout),此后该页面所用的卡就是账户的银行卡。对运营方 (GET /internal/charges),则按收款方的说法给出原因。由 Stripe 收款时:发卡行的拒绝代码,或 Stripe 自己的代码,使用 Stripe 的原话;no_payment_method(账户没有银行卡);authentication_required(发卡行要求对付款进行验证,而当时无人在场完成:需要在付款页面付款);invoice_voided、invoice_uncollectible(其发票在付款之前在 Stripe 被作废,或被标记为无法收款)。在付款页面支付的扣款:checkout_expired(页面到期未付,或从未创建)、card_used_elsewhere(这张卡支付的账户已达上限;已付款项已退还)、payment_failed(在页面上支付的款项没有到账)、stripe_unavailable、stripe_refused或 Stripe 自己的代码(没有创建页面)。替代收款方的:stand_in。