- API 凭据
- Swish 号码
- 证书(PEM)
- 私钥(PEM)
设置 Swish 后,客户可以在你的预订页面上通过二维码和 BankID 付款,钱直接进入你的银行账户。开始之前,你需要:
- ✓一个瑞典企业银行账户。
- ✓一位拥有 Mobile BankID 的人担任你的证书联系人。
- ✓一位能在电脑上运行一条命令的人。
向你的银行申请 Swish Handel
向你的企业开户银行申请 Swish Handel(适用于网站的 Swish 协议),并指定你的证书联系人。随后银行会给你一个 Swish 号码:以 123 开头的十位数字。
创建你的 Swish 证书
创建证书大约需要 15 分钟。
- 1
创建密钥和签名请求
在终端中运行以下命令,把 5566778899 换成你的组织编号,把 1231234567 换成你的 Swish 号码:
openssl req -newkey rsa:4096 -nodes -keyout swish-private.key -out swish.csr -subj "/C=SE/O=5566778899/CN=1231234567"
它会生成 swish.csr(你的签名请求)和 swish-private.key(你的私钥)。请妥善保管私钥:它是你的企业在 Swish 的身份凭据。
- 2
登录 Swish 门户
由你的证书联系人打开 portal.swish.nu,输入你的组织编号和 Swish 号码,并用 Mobile BankID 确认。
- 3
粘贴签名请求
用文本编辑器打开 swish.csr,复制全部内容,包括 BEGIN 和 END 两行。把它粘贴到 New certificate 选项卡的 CSR 字段中。
- 4
生成证书
格式选择 PEM,签发方选择你银行的 BIC,然后生成证书。
- 5
保存证书
复制门户显示的全部证书文本,从第一行 BEGIN CERTIFICATE 到最后一行 END CERTIFICATE。在文本编辑器中将其保存为 swish-cert.pem。
在 TourTask 中添加 Swish
- 1
打开 Swish 卡片
前往 配置 → 付款方式,在 网上支付 → 支付网关 下点击 Swish 卡片。找不到?在卡片下方选择 显示所有网关。
- 2
选择国家和货币
在 国家 中选择你的 Swish 账户及其银行账户所在的国家,在 货币 中选择旅客付款所用的货币,然后点击 添加。之后如要更改其中任何一项,请用 移除 移除 Swish 后重新添加。
- 3
填写 API 凭据
在 验证 下,卡片为每一项提供一个字段:
Swish 号码
证书(PEM)
私钥(PEM)在字段外点击即可保存该字段。
- 4
启用 Swish
填写完所有字段后,点击 启用。卡片会变为 已启用,旅客即可在你的预订页面上使用 Swish 付款。每笔付款都直接进入你自己的 Swish 账户:TourTask 从不经手你的资金。
用一笔小额真实付款测试
Swish 没有测试模式:请立即用一笔小额真实付款进行测试。
- 1
预订你最便宜的行程
在你自己的预订页面上选择 Swish,并用手机上的 Swish 应用付款。
- 2
检查预订
你确认付款后,预订会立即显示为已付款,钱也已进入你的银行账户。
- 3
退还这笔付款
在预订中,从该笔付款的 ⋮ 操作菜单中选择退款。点击退还剩余,再点击通过 Swish 退款,然后点击保存。
续期你的 Swish 证书
Swish 证书的有效期通常约为两年。证书过期后,Swish 付款会停止,而 TourTask 不会提醒你。
把 Swish 门户中显示的到期日期记入你的日历,并设置提前几周的提醒。续期时,按同样的方法创建新证书,然后把它和新的私钥粘贴到 TourTask 中。
常见问题
可以,前提是它属于 Swish Handel 协议。这样就可以跳过银行这一步,直接从证书开始。
不必。Swish 始终以 SEK 收款,TourTask 会把预订总额换算成 SEK。
付款后最多 13 个月内,可全额或部分退款。点击取消预订后,TourTask 就无法再通过 Swish 退款。
签约前请向你的银行询问 Swish Handel 的费用。TourTask 本身的价格见定价页面。