Adyen

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

通过你自己的 Adyen 商户账户收取银行卡付款。

国家

  • 爱尔兰
  • 爱沙尼亚
  • 奥地利
  • 澳大利亚
  • 巴西

货币

  • AED
  • AUD
  • BRL
  • CAD
  • CHF
  • CZK
  • DKK
文档联系我们
API 凭据
  • 商户账户
  • API 密钥
  • API URL前缀
  • HMAC密钥

你将把 Adyen 商户账户连接到 TourTask:需要四项信息、一个 Webhook 和一笔测试付款。你需要的是 Adyen 正式账户,而不是测试账户,申请需要数周时间。

Adyen 面向交易量大的企业

Adyen 不提供自助注册。Adyen 不公开其最低账单金额:请向其销售团队询问。大多数小型运营商更适合使用其他支付网关。

申请 Adyen 正式账户


  1. 1

    联系 Adyen 销售团队

    填写 Adyen 的销售咨询表,并说明你销售旅游行程。Adyen 将旅游运营商视为受限行业,需要提交额外文件,审核时间也更长。

  2. 2

    签约前询问保证金

    Adyen 可能会扣留你的部分结算款作为保证金。对于提前数月付款的行程,这笔保证金可能很高。

复制你的 Adyen 信息


用具有 Merchant admin 角色的用户登录正式环境的 Customer Area:ca-live.adyen.com。请把每个值都准备好:创建 Webhook 后在 TourTask 中添加 Adyen 时,要一次性全部填入。

  1. 1

    复制商户账户

    在 Settings → Merchant accounts 下,复制商户账户(而不是公司账户)的代码,它要填入 TourTask 中的商户账户。

  2. 2

    复制 URL 前缀

    在 Developers → API URLs 下,复制 Prefix:只复制前缀,不要复制完整网址。它要填入 TourTask 中的 API URL前缀。

  3. 3

    创建 API 凭据

    选择你的公司账户,前往 Developers → API credentials,打开 Payments 选项卡。选择 Create new credential,选择 Web service user,再选择 Create credential。

  4. 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. 1

    添加 Standard webhook

    在正式环境的 Customer Area 中,前往 Developers → Webhooks,选择 Create new webhook,然后点击 Standard webhook 旁的 Add。

  2. 2

    为你的商户账户启用它

    在 General 下开启 Enabled,并确认 Merchant accounts 中包含你的商户账户。

  3. 3

    输入 TourTask 地址

    在 Server configuration 下,把上面的 TourTask 地址粘贴到 URL。

  4. 4

    生成 HMAC 密钥

    在 Security 下,选择 HMAC Key 旁的编辑图标,然后选择 Generate。Adyen 只显示一次密钥:请复制下来,用于 TourTask 中的 HMAC密钥。

  5. 5

    选择 Save configuration

    之后跳过 Test configuration:即使 Webhook 设置正确,它也会失败。

在 TourTask 中添加 Adyen


  1. 1

    打开 Adyen 卡片

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

  2. 2

    选择国家和货币

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

  3. 3

    填写 API 凭据

    在 验证 下,卡片为每一项提供一个字段:
    商户账户
    API 密钥
    API URL前缀
    HMAC密钥

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

  4. 4

    启用 Adyen

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

测试 Adyen


TourTask 没有 Adyen 测试模式,因此请用一笔小额真实预订进行测试,之后再退款。

  1. 1

    为一笔预订付款

    在你自己的预订页面上预订最便宜的行程,选择 Adyen,并用你自己的银行卡付款。回到预订页面后,预订会自动确认。

  2. 2

    退还这笔付款

    在预订中,从该笔付款的操作菜单中选择退款,然后选择通过 Adyen 退款。

先退款,再取消

已取消的预订无法通过 Adyen 退款。

  1. 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 自己的付款页面,因此无需为此做任何设置。

这个页面对你有帮助吗?