在 Shopify 上使用 Adyen

Adyen 是一款供企业接受付款的支付网关。拥有现有 Adyen 账户的商家可以直接在 Shopify 中将 Adyen 用作其付款处理方。

您可以将 Shopify(包括 Adyen 的付款数据)与您的企业资源规划 (ERP) 软件进行集成,以确保各系统之间的数据管理和同步更加顺畅。

在 Shopify 上使用 Adyen 的资格要求

在 Shopify 上使用 Adyen 之前,您必须满足以下要求:

  • 您必须使用企业套餐。
  • 您的业务必须满足基于您所在区域的特定资格标准。
  • 在激活集成之前,您必须已设置好 Adyen 账号
  • 您的商店必须使用 Shopify Checkout

Adyen 访问权限仅限批准后获取,且无法保证一定能获得批准。若要请求激活 Adyen,请联系您的 Shopify 销售代表或商家成功经理 (CSM)。如果您没有商家成功经理,则可以联系 Shopify 支持团队,以获取有关后续步骤的指导。

在 Shopify 上使用 Adyen 时不兼容或不可用的功能

在使用 Shopify 上的 Adyen 集成时,某些功能不可用或不兼容:

  • Klarna 和 PayPal 不可用:Adyen 在 Shopify 上的集成不支持将 Klarna 和 PayPal 作为付款方式。
  • 部分本地付款方式不可用:Adyen 在 Shopify 上的集成所提供的本地付款方式 (LPM) 因区域而异,并且可能未涵盖 Adyen 直接提供的所有方式。有关完整列表,请参阅 Adyen 的付款方式文档
  • Shopify 欺诈工具不可用:使用 Adyen 时,您无法访问 Shopify Payments 欺诈工具,例如争议管理、卡片测试保护和欺诈分析。Adyen 提供了自己的欺诈预防工具(可能会收取额外的费用)。您仍然可以使用 Shopify 的欺诈分析功能和 Shopify Flow 来设置自定义规则。
  • 不支持 Managed MarketsManaged Markets(备案商家服务)需要使用 Shopify Payments,无法与 Adyen 结合使用。
  • 手动付款方式不支持多币种:多币种功能仅适用于信用卡。银行转账或货到付款等手动付款方式默认使用商店货币。

在 Shopify 上激活 Adyen

在您可以激活 Adyen 之前,请与您的 Shopify 销售代表或商家成功经理合作以获得批准。获得批准后,请设置 Adyen 账号,然后安装并激活支付应用。

步骤:

  1. 在 Shopify 后台中,转至设置 > 付款

  2. Shopify Payments 部分,点击管理

  3. 点击切换到第三方提供商,然后再次点击切换到第三方提供商以进行确认。

  4. 从可用的支付服务提供商列表中选择 Adyen Payments - Credit Cards。如果您未获准使用 Adyen,则 Adyen Payments - Credit Cards 选项不会显示在支付服务提供商列表中。

  5. 点击管理账户

  6. 如果需要,请允许 Adyen 付款扩展访问和修改您的商店数据。

  7. Adyen 付款配置页面上,选择要用于 Shopify 商店的 Adyen 账户。

  8. 按照 Adyen 客户区中的说明,安装适用于 Shopify 的 Adyen 支付应用并测试您的集成

配置 Adyen 设置

激活 Adyen 后,您可以配置设置以满足您的业务需求。

配置付款获取设置

付款获取设置决定了何时向您的客户收取资金。

步骤:

  1. 在 Shopify 后台中,转至设置 > 付款

  2. 在支付服务提供商部分中,点击管理

  3. 选择您首选的获取方式:

    • 自动获取:在下达订单时立即获取付款。
    • 手动获取:付款将获得授权,但在您手动获取之前不会被获取。
    • 发货时获取:在您为订单发货时获取付款。

安装本地付款方式

若要通过 Adyen 提供本地付款方式,您必须首先将 Adyen Payments - Credit Cards 应用作为主要网关安装。如果您尚未安装该信用卡应用,则无法安装本地付款方式。

安装该信用卡应用后,请联系您的商家成功经理或 Shopify 销售代表以获取针对您所在区域的本地付款方式的访问权限。

配置巴西和墨西哥的信用卡分期付款

如果您向巴西或墨西哥的客户进行销售,则可以在结账时提供信用卡分期付款。

在配置分期付款之前,请确认已满足以下要求:

  • 对于巴西,您的市场必须使用 BRL(巴西雷亚尔)货币。
  • 对于墨西哥,您的市场必须使用 MXN(墨西哥比索)货币。
  • 必须将 Adyen Payments - Credit Cards 应用作为主要网关安装。

步骤:

  1. 在 Shopify 后台中,转至设置 > 付款

  2. Adyen Payments - Credit Cards 部分中,点击管理

  3. 点击更多操作,然后点击管理

  4. 在浏览器的地址栏中,将 ?credit_card_installments=1 添加到 URL 的末尾,然后按键盘上的 Enter 键。

  5. 分期付款配置选项显示在页面底部。

  6. 配置最大分期付款期数和每期最低付款金额。巴西分期付款可以配置为 2 到 12 期。墨西哥分期付款可以配置为 3、6、9、12 或 18 期。

  7. 点击保存

将 Adyen 与 Shopify Markets 结合使用

Adyen 与 Shopify Markets 兼容。当 Shopify Markets 处于激活状态时,交易将以 Shopify 发送给 Adyen 的货币进行处理。

如要使用 Adyen 以多种货币进行销售,请验证是否满足以下要求:

  • 您的市场货币也必须在您的 Adyen 账户中进行配置。
  • 如果该货币是您所在区域的 Adyen 结算货币之一,则 Adyen 将以同一货币结算资金。

通过测试订单验证您的集成

在开始接受实际付款之前,请使用草稿订单测试您的 Adyen 集成,以确认付款处理正常。

步骤:

  1. 在 Shopify 后台中,转至订单 > 草稿

  2. 点击创建订单

  3. 添加产品和客户信息。

  4. 点击收款,然后选择您首选的付款方式。

  5. 完成付款流程,并验证订单是否在 Shopify 和您的 Adyen 门户中均正确显示。

使用 Adyen 时对订单进行对账

当使用 Adyen 支付订单时,Shopify 会向 Adyen 发送该交易的 merchantReference 编号。merchantReference 编号是一个独特的识别码,可用于对订单进行对账。

merchantReference 编号由两部分组成:

  • Shopify 商店 ID:编号的第一部分用于标识您的 Shopify 商店。
  • 付款 ID:第二部分是特定交易的付款 ID。

例如,merchantReference 编号可能会显示为 12345-67890。在此示例中,12345 是 Shopify 商店 ID,67890 是付款 ID。

交易的付款 ID 会显示在 Shopify 后台的订单时间线中。

如需对交易进行对账,请使用 merchantReference 编号中的付款 ID 部分在 Shopify 后台中进行搜索。搜索功能将返回与该付款 ID 关联的订单。

订单对账的注意事项

在结合使用订单时间线和付款 ID 对订单与 Adyen 中的交易进行对账时,请查看以下注意事项:

  • 查找订单的授权密钥:当使用 Adyen 完成交易时,授权密钥不会在 Shopify 后台的订单时间线上更新。如需检索订单的授权密钥,请参阅您的 Adyen 账户。
  • 待处理付款状态:付款可能需要几天时间来处理。如果未收到支付服务提供商的响应,则付款可能会显示为待处理。当付款状态变为已付款时,您可以为订单发货。
  • 已过期付款状态:如果付款状态更改为已过期,则请在再次向客户请求付款之前,确认您的 Adyen 账户并未收到此付款。付款状态变为已过期表示无法处理该笔付款。

对常见 Adyen 问题进行排查

如果您的 Adyen 集成出现问题,请查看以下常见问题及其解决方案。

对于支付宝(AliPay)和微信支付(WeChat Pay)等本地付款方式(LPM),这是预期行为。付款将进入待处理状态,直到处理方成功处理付款为止。付款确认后,Adyen 和 Shopify 中的状态便会更新。

操作步骤:等待付款处理完毕。大多数付款会在几分钟内更新,但有些付款可能需要 10-15 分钟。

如果客户发起了需要进行 3D 安全验证 的付款,但放弃了流程或遇到了 Shopify 无法控制的问题,便会出现这种情况。

操作步骤

  1. 查看您的 Adyen 门户以确认付款已获取。
  2. 如果已获取付款,则请在 Shopify 中创建草稿订单
  3. 将草稿订单标记为已付款并相应地为其发货。
  4. 如果未获取付款,则无需执行任何操作。

如果客户完成了 3D 安全验证,但未能正确重定向回 Shopify,则可能会发生这种情况。客户可能会在账单上发现两次授权尝试。

操作步骤

  1. 查看您的 Adyen 门户以确定实际获取了多少笔付款。
  2. 如果只获取了一笔付款,则建议客户:第二笔扣款是待处理的授权,其银行将自动撤销此授权。
  3. 如果获取了两笔付款,则请在您的 Adyen 门户中对重复交易进行退款。

如果 Adyen 处理付款被拒的时间比预期的更长,付款可能会变为待处理状态,而 Shopify 中则会创建相应的订单。

操作步骤

  1. 在 Shopify 后台和 Adyen 门户中检查付款状态。
  2. 如果付款失败,您可以取消订单,也可以再次向客户请求付款

当本地付款方式会话过期,但客户在 Adyen 中仍获得了授权时,可能会发生这种情况。

操作步骤

  1. 等待 10-15 分钟,以便 Adyen 和 Shopify 同步付款状态。
  2. 如果付款在 Adyen 中显示为完成,但 15 分钟后 Shopify 中仍未创建订单,则请创建草稿订单并手动将其标记为已付款。

此错误通常表明您的商店不符合使用 Adyen 的资格要求。

操作步骤

  1. 验证您的商店是否使用企业套餐。
  2. 请联系您的商家成功经理 (CSM) 或 Shopify 销售代表以讨论相关资格和激活事宜。
  3. 如果您没有商家成功经理,请联系 Shopify 支持团队以获取后续步骤指引。

如果未向您的客户显示本地付款方式,请验证是否满足以下要求:

  • 必须安装 Adyen Payments - Credit Cards 应用并将其作为您的主要网关。如果没有该应用,您将无法使用本地付款方式。
  • 客户的收货地址必须位于提供该本地付款方式的区域。
  • 结账货币必须受该本地付款方式支持。

操作步骤

  1. 确认已安装并激活 Adyen Payments - Credit Cards 应用。
  2. 验证您的本地付款方式是否已在 Adyen 账户中正确配置。
  3. 使用目标区域中的客户地址测试结账功能。

如果未向巴西或墨西哥客户显示信用卡分期付款,请验证是否满足以下要求:

  • 对于巴西,市场必须使用 BRL(巴西雷亚尔)货币。
  • 对于墨西哥,市场必须使用 MXN(墨西哥比索)货币。
  • 必须安装 Adyen Payments - Credit Cards 应用并将其作为您的主要网关。
  • 必须使用 URL 参数激活分期付款。
  • 未使用商店抵扣额和第三方礼品卡付款应用(这些与分期付款不兼容)。

常见问题解答

不能。若要使用 Adyen 处理本地付款方式,您必须安装 Adyen Payments - Credit Cards 应用并将其作为您的主要网关。Adyen 要求采用此配置,并会监控使用情况以防止出现部分集成。

不能。Adyen 的支付服务提供商 (PSP) 参考信息并未存储在 Shopify 中。但是,Shopify 交易参考信息作为 merchantReference 字段的一部分存储在您的 Adyen 门户中,您可以将其用于对账。

是的,Adyen 支付应用可通过与 Shopify 结账集成的订阅应用来支持订阅。如果您需要将现有订阅迁移至 Adyen,请联系您的商家成功经理 (CSM) 或 Shopify 销售代表以探讨迁移选项。

是的,通过 Adyen 集成可以使用 Apple Pay(适用于 iOS)和 Google Pay(适用于 Android)。

是的,Adyen 应用通过购买后结账扩展程序支持购买后增销。有关购买后结账扩展程序的限制和注意事项,请参阅 Shopify 开发者文档

旧版 Adyen 网关不再受支持,且可能会导致支付问题。如果您仍在使用旧版 Adyen 网关,应立即迁移到新的 Adyen 支付应用。

要进行迁移,请联系 Shopify 支持或您的商家成功经理,获取有关迁移流程的指导。

在就 Adyen 问题联系 Shopify 支持之前

在就 Adyen 问题联系 Shopify 支持之前,请收集以下信息以帮助更快地解决问题:

  • 受该问题影响的订单号
  • 问题发生的日期和时间
  • 您收到的任何错误消息的屏幕截图
  • 您的 Shopify 后台和 Adyen 门户中显示的支付状态
  • Adyen 提供的 merchantReference 编号(如果适用)
  • 对预期结果与实际结果的描述
  • 您已根据故障排除部分尝试过的步骤

Adyen 支持和资源

了解在通过 Shopify 使用 Adyen 时应联系哪个团队寻求支持,可改善您的体验并帮助您更快地获得解答。

Shopify 支持的职责

如果需要有关在 Shopify 上集成 Adyen 的帮助,包括设置、配置和常见问题故障排除等方面的帮助,请首先联系 Shopify 支持。Shopify 支持可协助处理以下类型的问题:

  • 请求访问和激活 Shopify 上的 Adyen 支付网关
  • 在 Shopify 上与 Adyen 支付网关相关的技术问题
  • 针对集成问题进行故障排除
  • 有关在 Shopify 中配置和管理 Adyen 设置的指导

Adyen 支持的职责

对于您 Adyen 账户的特定问题,请通过 support@adyen.com 直接联系 Adyen 支持团队。Adyen 支持团队会处理以下类型的咨询:

  • 账户验证和商家初始启用
  • 合规性
  • 定价和处理费率
  • 交易款项发放时间表、失败的交易款项以及其他与交易款项相关的问题
  • 欺诈预防策略和工具
  • 拒付和争议管理
  • 详细的报告和对账需求

资源

要详细了解 Adyen 及其与 Shopify 的集成,请参阅以下资源: