文档

付款

连接 Stripe

买家付款到你自己的 Stripe 账户。我们在该账户上创建每次结账,并监听 Stripe 的事件。我们从不经手资金,也从不接触卡号。

连接你的账户

  1. 打开“付款”。在付款中的 Stripe 下,在“测试”一侧选择“连接”,然后说明你是否已有 Stripe 账户。
  2. 完成 Stripe 的入驻流程。会打开 Stripe 自己的页面。它们会为你的应用设置一个关联账户,并可从你已有的 Stripe 账户复制已验证的信息。
  3. 确认已连接。回到“支付”页面,测试一侧显示“已连接”,以及账户名称和 ID。
  4. 上线时连接正式账户。准备好收取真实款项时,在正式一侧执行相同操作。
  • 一个连接适用于你的所有应用。
  • 测试和正式分别连接。
  • 如果你登录已超过 10 分钟,连接或断开时会要求再次确认身份。
  • 断开正式连接后,重新连接前无法发起新的 Stripe 结账。已付费的手表保持解锁。

或使用你自己的密钥

选择“使用我自己的密钥”,粘贴一个受限密钥,需对 Checkout Sessions 有读写权限,对 charges 和 refunds 有读取权限。保存前我们会用一次只读调用测试它,加密存储,此后只显示最后 4 个字符。私密密钥会被拒绝:受限密钥只能做我们需要的事。

你的 Stripe 账户

  • 账户归你所有。你可以使用完整的 Stripe 控制台。扣款在你的账户上进行,所以你是卖家。
  • 结算由 Stripe 负责。结算,以及 Stripe 认定你的账户符合条件时的即时结算(Instant Payouts),都在你的 Stripe 控制台中。
  • 手续费归 Stripe。Stripe 自己的手续费由你承担,在 Stripe 中扣除。我们不从销售中抽成。
  • Apple Pay 和 Google Pay 无需设置即可在 Stripe 托管的结账页面中显示。
  • 本地支付方式会在适合价格币种时显示:Alipay 和 WeChat Pay,以及欧元或兹罗提价格下的 iDEAL、Bancontact、EPS、Przelewy24 和 BLIK。在 Stripe 中开启你需要的方式:设置,然后支付方式。未开启的不会显示。它们都即时付款,所以手表会立即解锁。
  • 设置清晰的账单描述,例如应用名称,让买家在账单上认出这笔扣款。

我们监听的内容

这样连接时,你无需添加 Webhook:Stripe 会把你账户的事件发送给我们。

Stripe 事件含义手表的表现
checkout.session.completed已付款如果购买界面打开,约一秒内解锁;否则在下次询问时解锁。
charge.refunded已退款在下次检查时锁定;如果购买界面打开则立即锁定。
charge.dispute.created发起了争议争议未结期间锁定。
charge.dispute.closed争议已结束胜诉:重新解锁,除非已退款。败诉:保持锁定。
radar.early_fraud_warning.created欺诈警告保持解锁。我们会通知你,以便你在产生争议费用前退款。
invoice.paid续订已付款保持解锁。
invoice.payment_failed续订被拒锁定。买家会被要求更新银行卡。
invoice.payment_action_required银行要求买家确认显示一个指向 Stripe 账单页面的 QR 码。
订阅 canceled、unpaid 或 paused已取消,或重试次数用完锁定。

我们会将每个事件与我们创建的结账核对:元数据中的手表和应用、金额、货币,以及是测试还是正式。

如果 Stripe 无法连到我们

“支付”页面会显示“需要处理”和修复方法。在此期间付款仍会正常进行,但在 Stripe 重新连上我们之前,退款和争议无法锁定手表。

退款和争议

  • 在 Stripe 控制台中退款。销售中的每笔销售都直接链接到那里。
  • 退还订阅扣款不会停止订阅。还需在 Stripe 中取消订阅。
  • 在 Stripe 中处理争议。争议未结期间,手表保持锁定。

每种情况下手表一侧的表现见退款、争议与续订。

用 Stripe 测试

  • 使用 4242 4242 4242 4242、任意未来日期和任意 CVC 付款。
  • 用 4000 0000 0000 0259 制造测试争议。
  • 在 Stripe 的测试控制台中退款。

切勿在你的正式账户上测试退款、扣款被拒或争议。请使用测试模式。

Esc