- API 凭据
- 商户账户
- API 密钥
- API URL前缀
- HMAC密钥
你将把 Adyen 商户账户连接到 TourTask:需要四项信息、一个 Webhook 和一笔测试付款。你需要的是 Adyen 正式账户,而不是测试账户,申请需要数周时间。
申请 Adyen 正式账户
- 1
联系 Adyen 销售团队
填写 Adyen 的销售咨询表,并说明你销售旅游行程。Adyen 将旅游运营商视为受限行业,需要提交额外文件,审核时间也更长。
- 2
签约前询问保证金
Adyen 可能会扣留你的部分结算款作为保证金。对于提前数月付款的行程,这笔保证金可能很高。
复制你的 Adyen 信息
用具有 Merchant admin 角色的用户登录正式环境的 Customer Area:ca-live.adyen.com。请把每个值都准备好:创建 Webhook 后在 TourTask 中添加 Adyen 时,要一次性全部填入。
- 1
复制商户账户
在 Settings → Merchant accounts 下,复制商户账户(而不是公司账户)的代码,它要填入 TourTask 中的商户账户。
- 2
复制 URL 前缀
在 Developers → API URLs 下,复制 Prefix:只复制前缀,不要复制完整网址。它要填入 TourTask 中的 API URL前缀。
- 3
创建 API 凭据
选择你的公司账户,前往 Developers → API credentials,打开 Payments 选项卡。选择 Create new credential,选择 Web service user,再选择 Create credential。
- 4
生成 API 密钥
在 Server settings → Authentication 下,打开 API key 选项卡并选择 Generate API key。Adyen 只显示一次密钥:请复制下来,用于 TourTask 中的 API 密钥,然后在 Adyen 中选择 Save changes。
创建 Webhook
没有这个 Webhook,旅客会被扣款,但预订会一直未确认。
你用于 Adyen 的 TourTask Webhook 地址
https://api.tourtask.com/v1/payments/adyen/notifications/booking- 1
添加 Standard webhook
在正式环境的 Customer Area 中,前往 Developers → Webhooks,选择 Create new webhook,然后点击 Standard webhook 旁的 Add。
- 2
为你的商户账户启用它
在 General 下开启 Enabled,并确认 Merchant accounts 中包含你的商户账户。
- 3
输入 TourTask 地址
在 Server configuration 下,把上面的 TourTask 地址粘贴到 URL。
- 4
生成 HMAC 密钥
在 Security 下,选择 HMAC Key 旁的编辑图标,然后选择 Generate。Adyen 只显示一次密钥:请复制下来,用于 TourTask 中的 HMAC密钥。
- 5
选择 Save configuration
之后跳过 Test configuration:即使 Webhook 设置正确,它也会失败。
在 TourTask 中添加 Adyen
- 1
打开 Adyen 卡片
前往 配置 → 付款方式,在 网上支付 → 支付网关 下点击 Adyen 卡片。找不到?在卡片下方选择 显示所有网关。
- 2
选择国家和货币
在 国家 中选择你的 Adyen 账户及其银行账户所在的国家,在 货币 中选择旅客付款所用的货币,然后点击 添加。之后如要更改其中任何一项,请用 移除 移除 Adyen 后重新添加。
- 3
填写 API 凭据
在 验证 下,卡片为每一项提供一个字段:
商户账户
API 密钥
API URL前缀
HMAC密钥在字段外点击即可保存该字段。
- 4
启用 Adyen
填写完所有字段后,点击 启用。卡片会变为 已启用,旅客即可在你的预订页面上使用 Adyen 付款。每笔付款都直接进入你自己的 Adyen 账户:TourTask 从不经手你的资金。
测试 Adyen
TourTask 没有 Adyen 测试模式,因此请用一笔小额真实预订进行测试,之后再退款。
- 1
为一笔预订付款
在你自己的预订页面上预订最便宜的行程,选择 Adyen,并用你自己的银行卡付款。回到预订页面后,预订会自动确认。
- 2
退还这笔付款
在预订中,从该笔付款的操作菜单中选择退款,然后选择通过 Adyen 退款。
- 3
取消测试预订
如果测试付款失败
- 付款立即失败:请检查四项信息是否都来自正式环境的 Customer Area。商户账户必须是商户账户的代码,而不是公司账户的代码。
- 已付款,但预订未确认:在正式环境的 Customer Area 中,检查该 Webhook 是否为 Enabled、是否包含你的商户账户,以及 URL 是否与上面的地址完全一致。如果都没问题,请为它生成新的 HMAC Key,并粘贴到 TourTask 中的 HMAC密钥。然后在 Adyen 中选择 Save configuration。
常见问题
就是在 Adyen 的 Customer Area 中为你的商户账户开启的那些方式。TourTask 不会对它们进行筛选。
通常需要几天。TourTask 会立即记录退款,款项何时退回可在你的 Adyen Customer Area 中查看。
不需要。TourTask 会把旅客转到 Adyen 自己的付款页面,因此无需为此做任何设置。