Обновление до последней версии

Начиная с июля 2018 г. в Google Pay API используются новые структуры объектов для PaymentDataRequest и IsReadyToPayRequest. Из этого руководства вы узнаете, как изменить формат объектов для Google Pay API версии 1, чтобы он соответствовал формату версии 2.

Способы оплаты

В Google Pay API версии 2 для каждого объекта запроса требуется указывать версию API.

В Google Pay API версии 1 поддерживался только один способ оплаты – с помощью карты. В Google Pay API версии 2, помимо CARD, существует множество других вариантов оплаты. Если раньше на сайте для параметра CARD использовалось значение allowedPaymentMethods, теперь нужно использовать параметр allowedAuthMethods со значением PAN_ONLY. Если для параметра TOKENIZED_CARD было установлено значение allowedPaymentMethods, следует использовать параметр CRYPTOGRAM_3DS со значением allowedAuthMethods.

Поддерживаемые платежные системы указываются вместе с допустимыми методами аутентификации карт в этих системах.

apiVersion 1

{
  allowedPaymentMethods: [
    'CARD',
    'TOKENIZED_CARD'
  ],
  cardRequirements: {
    allowedCardNetworks: [
      'AMEX',
      'DISCOVER',
      'JCB',
      'MASTERCARD',
      'VISA'
    ]
  }
}

apiVersion 2

{
  apiVersion: 2,
  apiVersionMinor: 0,
  allowedPaymentMethods: [{
    type: 'CARD',
    parameters: {
      allowedAuthMethods: [
        'PAN_ONLY',
        'CRYPTOGRAM_3DS'
      ],
      allowedCardNetworks: [
        'AMEX',
        'DISCOVER',
        'JCB',
        'MASTERCARD',
        'VISA'
      ]
    }
  }]
}

Поддерживаемые платежные системы и методы аутентификации для способа оплаты CARD указываются с помощью параметра IsReadyToPayRequest.

Токенизация платежных данных карт

Google Pay API возвращает зашифрованные данные карты, которые передаются на указанный шлюз или расшифровываются на серверах. В Google Pay API версии 2 токенизация способа оплаты выполняется внутри объекта, определяющего способ оплаты CARD.

apiVersion 1

{
  paymentMethodTokenizationParameters: {
    tokenizationType: 'PAYMENT_GATEWAY',
    parameters: {
      'gateway': 'example',
      'gatewayMerchantId': 'exampleMerchantId'
    }
  }
}

apiVersion 2

{
  allowedPaymentMethods: [{
    type: 'CARD',
    tokenizationSpecification: {
      type: 'PAYMENT_GATEWAY',
      parameters: {
        'gateway': 'example',
        'gatewayMerchantId': 'exampleMerchantId'
      }
    }
  }]
}

Идентификатор продавца Google

В Google Pay API версии 1 идентификатор продавца Google представлял собой свойство верхнего уровня. Теперь этот идентификатор указывается внутри объекта MerchantInfo с необязательным названием продавца.

apiVersion 1

{
  merchantId: '01234567890123456789'
}

apiVersion 2

{
  merchantInfo: {
    merchantId: '01234567890123456789'
  }
}

Платежный адрес

Платежный адрес и телефон связаны со способом оплаты CARD и являются необязательными свойствами. Если сайт запрашивает платежный адрес, то конфигурация, связанная с ожидаемым ответом, вкладывается в объект BillingAddressParameters.

apiVersion 1

{
  cardRequirements: {
    billingAddressRequired: true,
    billingAddressFormat: 'FULL'
  },
  phoneNumberRequired: true
}

apiVersion 2

{
  allowedPaymentMethods: [{
    type: 'CARD',
    parameters: {
      billingAddressRequired: true,
      billingAddressParameters: {
        format: 'FULL',
        phoneNumberRequired: true
      }
    }
  }]
}

Адрес доставки

Адрес доставки является необязательным свойством верхнего уровня для объекта PaymentDataRequest. Название свойства shippingAddressRequirements было изменено на shippingAddressParameters.

Ранее в ответах Google Pay API, содержащих адрес доставки, мог передаваться номер телефона. Эта возможность больше не поддерживается ни в одной из версий Google Pay API. Обработчики ответов, ожидающие номер телефона, необходимо обновить.

apiVersion 1

{
  shippingAddressRequired: true,
  shippingAddressRequirements: {
    allowedCountryCodes: [
      'US',
      'CA'
    ]
  }
}

apiVersion 2

{
  shippingAddressRequired: true,
  shippingAddressParameters: {
    allowedCountryCodes: [
      'US',
      'CA'
    ]
  }
}

Ответ PaymentData

Объект ответа PaymentData для сайтов, где для свойства apiVersion объекта 2 указано значение PaymentDataRequest, теперь определяет карты как один из вариантов оплаты. Свойства apiVersion и apiVersionMinor из объекта PaymentDataRequest указываются в ответе PaymentData для определения ожидаемого формата.

apiVersion 1

{
  // no version specified
}

apiVersion 2

{
  apiVersion: 2,
  apiVersionMinor: 0
}

Свойство paymentMethodData содержит информацию о выбранном способе оплаты и токенизации. Из объекта cardInfo были исключены два свойства: cardClass и cardImageUri.

apiVersion 1

{
  cardInfo: {
    cardDescription: 'Visa •••• 1234',
    cardNetwork: 'VISA',
    cardDetails: 1234
  },
  paymentMethodToken: {
    tokenizationType: 'PAYMENT_GATEWAY',
    token: 'examplePaymentMethodToken'
  }
}

apiVersion 2

{
  paymentMethodData: {
    type: 'CARD',
    description: 'Visa •••• 1234',
    info: {
      cardNetwork: 'VISA',
      cardDetails: '1234'
    },
    tokenizationData: {
      type: 'PAYMENT_GATEWAY',
      token: 'examplePaymentMethodToken'
    }
  }
}

Ответ с зашифрованным сообщением

Если на сайте указан тип токенизации способа оплаты DIRECT и сайт принимает способ оплаты TOKENIZED_CARD из API версии 1, следует обновить способ обработки расшифрованного свойства encryptedMessage, чтобы по-прежнему передавать шлюзу или обработчику токены устройств Android, аутентифицированные с помощью криптограммы 3-D Secure, и необязательные индикаторы ECI. Вариант оплаты картой указывается с помощью значения CARD для paymentMethod, а метод аутентификации – с помощью дополнительного свойства paymentMethodDetails.authMethod.

apiVersion 1

{
  "paymentMethod": "TOKENIZED_CARD",
  "paymentMethodDetails": {
    "authMethod": "3DS",
    "dpan": "1111222233334444",
    "expirationMonth": 10,
    "expirationYear": 2020,
    "3dsCryptogram": "AAAAAA...",
    "3dsEciIndicator": "eci indicator"
  }
}

apiVersion 2

{
  "paymentMethod": "CARD",
  "paymentMethodDetails": {
    "authMethod": "CRYPTOGRAM_3DS",
    "pan": "1111222233334444",
    "expirationMonth": 10,
    "expirationYear": 2020,
    "cryptogram": "AAAAAA...",
    "eciIndicator": "eci indicator"
  }
}