- API 凭据
- API 密钥
- Webhook 密钥
设置 Stripe 后,旅客会在 Stripe 自己的付款页面上用银行卡付款,返回时预订已付款。你需要在上方所列国家之一拥有银行账户。
创建你的 Stripe 账户
- 1
注册 Stripe
在 dashboard.stripe.com/register 创建账户。请谨慎选择企业所在国家:账户正式启用后,Stripe 无法更改它。
- 2
验证你的企业
在 dashboard.stripe.com/account/onboarding 完成申请:填写你的企业信息、企业负责人信息以及接收结算款的银行账户。Stripe 验证通过后,即可开始收取真实付款。
复制你的 Stripe 密钥
- 1
打开你的 API 密钥
前往 dashboard.stripe.com/apikeys,从沙盒切换到正式模式。
- 2
复制密钥
在 Standard keys 下,点击 Reveal live key,复制 Secret key:它以 sk_live_ 开头。请妥善保密:任何拿到它的人都能以你的名义收款和退款。
在 Stripe 中添加 TourTask Webhook
Webhook 会把每笔付款通知 TourTask,即使款项几天后才结清,或者旅客再也没有返回。
你用于 Stripe 的 TourTask Webhook 地址
https://api.tourtask.com/v1/payments/stripe/notifications/booking- 1
创建事件目标
在正式模式下前往 dashboard.stripe.com/webhooks,点击 Create an event destination。
- 2
选择你的账户和 Snapshot
选择 Your account 和 Snapshot 负载格式:TourTask 无法读取 Stripe 推荐的 Thin 事件。API 版本保持不变。
- 3
选择这两个事件
勾选 checkout.session.completed 和 checkout.session.async_payment_succeeded,不要勾选其他事件。
- 4
选择 Webhook 端点
点击 Continue,选择 Webhook endpoint 作为目标类型。
- 5
输入 TourTask 地址
点击 Continue,把上面的 TourTask 地址粘贴到 Endpoint URL,然后创建目标。
- 6
复制签名密钥
在该目标的页面上点击 Reveal secret,复制签名密钥:它以 whsec_ 开头。
在 TourTask 中添加 Stripe
- 1
打开 Stripe 卡片
前往 配置 → 付款方式,在 网上支付 → 支付网关 下点击 Stripe 卡片。找不到?在卡片下方选择 显示所有网关。
- 2
选择国家和货币
在 国家 中选择你的 Stripe 账户及其银行账户所在的国家,在 货币 中选择旅客付款所用的货币,然后点击 添加。之后如要更改其中任何一项,请用 移除 移除 Stripe 后重新添加。
- 3
填写 API 凭据
在 验证 下,卡片为每一项提供一个字段:
API 密钥
Webhook 密钥在字段外点击即可保存该字段。
- 4
启用 Stripe
填写完所有字段后,点击 启用。卡片会变为 已启用,旅客即可在你的预订页面上使用 Stripe 付款。每笔付款都直接进入你自己的 Stripe 账户:TourTask 从不经手你的资金。
要添加附加费或调整付款方式的顺序,请参见网上支付。
检查 Stripe 是否正常工作
TourTask 没有 Stripe 测试模式,而 Stripe 的条款禁止用真实银行卡进行测试付款。
- 1
打开 Stripe 的付款页面
在你自己的预订页面上预订一个行程并选择 Stripe。Stripe 的付款页面打开后,不付款直接关闭。
- 2
取消测试预订
在 TourTask 中打开该预订,点击取消预订。
- 3
检查你的第一笔付款
旅客用 Stripe 付款后,预订会显示为已付款,这笔付款也会出现在你的 Stripe Dashboard 中。
- 4
检查 Webhook
在 Stripe 中打开该目标的 Event deliveries 选项卡:checkout.session.completed 应显示为 Delivered。如果失败,请检查端点 URL、Snapshot 格式和 Webhook 密钥。
常见问题
就是你在 Stripe Dashboard 的付款方式设置中开启的那些方式。稍后才结清的方式(例如银行借记)只有在款项到账后,才会把预订标记为已付款。
不必。TourTask 会把预订总额换算成你为该网关选择的货币。
不会。付款会进入你自己的 Stripe 账户,再由 Stripe 结算到你的银行账户。