信用卡存款端点现在需要 mTLS 证书

Shopify 的卡数据托管端点现在要求使用 Shopify 签发的 mTLS 客户端证书。通过 customerPaymentMethodCreditCardCreate 和 customerPaymentMethodCreditCardUpdate GraphQL 管理 API 变更存储持卡人数据的应用，必须首先在 Shopify 的 /sessions 卡数据托管端点托管这些数据以获取会话标识符。该托管调用必须在 2026 年 10 月 15 日 之前出示 Shopify 签发的证书。这是一项强制性变更：强制执行开始后，托管请求必须包含有效证书。如果您的应用托管持卡人数据，则必须进行更新。

变更内容

https://checkout-mtls.pci.shopifyinc.com/sessions 处的卡数据托管端点本身未发生变化。新变化是，对该端点的每个请求都必须出示 Shopify 签发的 mTLS 客户端证书。此前，对此端点的请求不需要客户端证书。

GraphQL 管理 API 的金库变更未受影响。您继续使用由托管调用返回的会话标识符调用 customerPaymentMethodCreditCardCreate 和 customerPaymentMethodCreditCardUpdate，且您的 GraphQL 管理 API OAuth 流程不受影响。

customerPaymentMethodRemoteCreate 不在范围内。它仅引用外部网关中已持有的支付方式，并不向 Shopify 存储任何持卡人数据。

受影响对象

此规定适用于通过 customerPaymentMethodCreditCardCreate 或 customerPaymentMethodCreditCardUpdate 向 Shopify 托管持卡人数据的应用。

仅调用 customerPaymentMethodRemoteCreate 从 Stripe、Braintree、Authorize.Net、Adyen 或 PayPal 等外部网关导入支付方式的应用不受影响，无需采取任何行动。

为何重要

所有到达存款端点的持卡人数据流量必须可追溯至经过身份验证的调用方。要求使用客户端证书使 Shopify 能够在 2026 年黑色星期五和网络星期一一周前验证谁正在存入卡片数据，这是拒绝未认证存款流量的前提条件。

操作指南

如果您的应用托管持卡人数据，请在 2026 年 10 月 15 日 之前完成迁移：

1. 确认您的应用是否调用 customerPaymentMethodCreditCardCreate 或 customerPaymentMethodCreditCardUpdate。如果仅调用 customerPaymentMethodRemoteCreate，则无需采取行动。
2. 在 shopify-mtls-partnerships@shopify.com 申请 Shopify 签发的客户端证书。请包含您的 API 客户端 ID 和技术联系人。首批证书由 Shopify 手动签发，需要几天时间，因此请尽早开始。
3. 在您的 /sessions 托管调用中出示该证书，并继续按原样传递返回的会话标识符给金库变更。
4. 确认您的存款流量现在附带有效证书。Shopify 将在其侧验证切换过程。

在首次获取证书后，请在 1 年有效期到期前通过 Shopify 的证书签名服务自行轮换证书。无需 Shopify 介入。若错过轮换，将导致存款功能停止，因此请将证书过期监控纳入标准可观测性流程中。

未在 2026 年 10 月 15 日前完成迁移的应用程序，一旦强制执行证书要求，将失去存入新持卡人数据的能力。

相关文档

• customerPaymentMethodCreditCardCreate 参考
• customerPaymentMethodCreditCardUpdate 参考