Stripe

如何通过 Stripe 收取银行卡付款

在 Stripe 自己的付款页面上收取银行卡付款。

国家

  • 阿拉伯联合酋长国
  • 爱尔兰
  • 爱沙尼亚
  • 奥地利
  • 澳大利亚

货币

  • AED
  • AFN
  • ALL
  • AMD
  • ANG
  • AOA
  • ARS
文档联系我们
API 凭据
  • API 密钥
  • Webhook 密钥

设置 Stripe 后,旅客会在 Stripe 自己的付款页面上用银行卡付款,返回时预订已付款。你需要在上方所列国家之一拥有银行账户。

Stripe 限制部分旅游业务

旅行预订服务需要提交额外文件,而且 Stripe 仍可能拒绝。航空公司、邮轮和分时度假被禁止。请先查看 Stripe 的清单。

想在你自己的预订页面上显示银行卡输入框?

请改用 Stripe Elements,或同时使用两者:它使用同一个 Stripe 账户。

创建你的 Stripe 账户


  1. 1

    注册 Stripe

    在 dashboard.stripe.com/register 创建账户。请谨慎选择企业所在国家:账户正式启用后,Stripe 无法更改它。

  2. 2

    验证你的企业

    在 dashboard.stripe.com/account/onboarding 完成申请:填写你的企业信息、企业负责人信息以及接收结算款的银行账户。Stripe 验证通过后,即可开始收取真实付款。

复制你的 Stripe 密钥


  1. 1

    打开你的 API 密钥

    前往 dashboard.stripe.com/apikeys,从沙盒切换到正式模式。

  2. 2

    复制密钥

    在 Standard keys 下,点击 Reveal live key,复制 Secret key:它以 sk_live_ 开头。请妥善保密:任何拿到它的人都能以你的名义收款和退款。

切勿粘贴测试密钥

测试密钥(sk_test_)不会报错:预订会被标记为已付款,但用的是测试资金,永远不会到达你的银行账户。

在 Stripe 中添加 TourTask Webhook


Webhook 会把每笔付款通知 TourTask,即使款项几天后才结清,或者旅客再也没有返回。

你用于 Stripe 的 TourTask Webhook 地址

https://api.tourtask.com/v1/payments/stripe/notifications/booking
  1. 1

    创建事件目标

    在正式模式下前往 dashboard.stripe.com/webhooks,点击 Create an event destination。

  2. 2

    选择你的账户和 Snapshot

    选择 Your account 和 Snapshot 负载格式:TourTask 无法读取 Stripe 推荐的 Thin 事件。API 版本保持不变。

  3. 3

    选择这两个事件

    勾选 checkout.session.completed 和 checkout.session.async_payment_succeeded,不要勾选其他事件。

  4. 4

    选择 Webhook 端点

    点击 Continue,选择 Webhook endpoint 作为目标类型。

  5. 5

    输入 TourTask 地址

    点击 Continue,把上面的 TourTask 地址粘贴到 Endpoint URL,然后创建目标。

  6. 6

    复制签名密钥

    在该目标的页面上点击 Reveal secret,复制签名密钥:它以 whsec_ 开头。

在 TourTask 中添加 Stripe


  1. 1

    打开 Stripe 卡片

    前往 配置 → 付款方式,在 网上支付 → 支付网关 下点击 Stripe 卡片。找不到?在卡片下方选择 显示所有网关。

  2. 2

    选择国家和货币

    在 国家 中选择你的 Stripe 账户及其银行账户所在的国家,在 货币 中选择旅客付款所用的货币,然后点击 添加。之后如要更改其中任何一项,请用 移除 移除 Stripe 后重新添加。

  3. 3

    填写 API 凭据

    在 验证 下,卡片为每一项提供一个字段:
    API 密钥
    Webhook 密钥

    在字段外点击即可保存该字段。

  4. 4

    启用 Stripe

    填写完所有字段后,点击 启用。卡片会变为 已启用,旅客即可在你的预订页面上使用 Stripe 付款。每笔付款都直接进入你自己的 Stripe 账户:TourTask 从不经手你的资金。

请选择只有 Stripe 标志的卡片:标志下方带有 ELEMENTS 的是另一个支付网关 Stripe Elements。

把密钥粘贴到 API 密钥,把签名密钥粘贴到 Webhook 密钥。

要添加附加费或调整付款方式的顺序,请参见网上支付。

检查 Stripe 是否正常工作


TourTask 没有 Stripe 测试模式,而 Stripe 的条款禁止用真实银行卡进行测试付款。

  1. 1

    打开 Stripe 的付款页面

    在你自己的预订页面上预订一个行程并选择 Stripe。Stripe 的付款页面打开后,不付款直接关闭。

  2. 2

    取消测试预订

    在 TourTask 中打开该预订,点击取消预订。

  3. 3

    检查你的第一笔付款

    旅客用 Stripe 付款后,预订会显示为已付款,这笔付款也会出现在你的 Stripe Dashboard 中。

  4. 4

    检查 Webhook

    在 Stripe 中打开该目标的 Event deliveries 选项卡:checkout.session.completed 应显示为 Delivered。如果失败,请检查端点 URL、Snapshot 格式和 Webhook 密钥。

常见问题


就是你在 Stripe Dashboard 的付款方式设置中开启的那些方式。稍后才结清的方式(例如银行借记)只有在款项到账后,才会把预订标记为已付款。

不必。TourTask 会把预订总额换算成你为该网关选择的货币。

不会。付款会进入你自己的 Stripe 账户,再由 Stripe 结算到你的银行账户。

这个页面对你有帮助吗?