payment_method.data.trusted_vault_origin — новое опциональное булево поле в релиз-кандидате Payments Apps API 2027-01. Оно передаёт сигнал о том, что карта поступила из хранилища, которому доверяет Shopify. Разработчики платёжных приложений могут учитывать этот сигнал при проверке CVV в запросах на оплату и верификацию кредитных карт.
Как trusted_vault_origin влияет на проверку CVV
Поле находится в payment_method.data, за пределами объекта с зашифрованными данными карты или платёжного инструмента. Оно может присутствовать в обоих форматах payload: с зашифрованными карточными данными и с данными платёжного инструмента.
При значении true приложение не должно отклонять платёж или верификацию только из-за отсутствия CVV. При этом сам CVV всё равно может присутствовать в запросе. Если поле содержит false или отсутствует, приложение сохраняет действующие правила обработки CVV, в том числе для сценариев без этого кода.
Доступ к полю требует включения со стороны Shopify
Функция доступна только приложениям, которые обрабатывают запросы с payment_method.type = credit_card и используют API версии 2027-01 или выше. Shopify также должен включить поле для конкретного приложения. Одного перехода на новую версию API недостаточно: поле не поступит в запросе, если Shopify не включил его или у платформы нет значения для отправки.
Немедленно переводить рабочие приложения на новую версию не требуется: версия 2027-01 предназначена для тестирования. Для интеграционной проверки нужно включить поле для приложения и проверить три состояния: true, false и отсутствие поля. Каждое состояние следует проверить с CVV и без него, во всех форматах payload, которые поддерживает приложение. Если приложение обрабатывает запросы верификации, их тоже нужно включить в проверку.
Первый шаг для подготовки тестирования — установить api_version: 2027-01 в dev-расширении.
