PaymentRequestUpdateEvent: метод updateWith()

Метод updateWith() интерфейса PaymentRequestUpdateEvent обновляет данные существующего объекта PaymentRequest.

details

Это может быть объект или Promise, который разрешается в объект, определяющий изменения, применённые к запросу оплаты:

displayItems Необязательно

Массив объектов, каждый из которых описывает один пункт в запросе оплаты. Эти пункты представляют строки на чеке или счёте, каждый с такими свойствами:

amount

Объект, описывающий денежную стоимость элемента. Этот объект включает следующие поля:

currency

Строка, содержащая допустимый трёхбуквенный идентификатор валюты ISO 4217 (ISO 4217), указывающий валюту оплаты value.

value

Строка, содержащая допустимое десятичное значение, представляющее сумму валюты, составляющую сумму оплаты. Эта строка может содержать только необязательный ведущий знак «-» для указания отрицательного значения, затем одну или несколько цифр от 0 до 9 и необязательную десятичную точку (".", независимо от региональных настроек) за которой следует как минимум одна цифра. Пробелы запрещены.

label

Строка, определяющая читаемое человеком имя или описание элемента или услуги, за которые взимается плата. Это может быть отображено пользователю агентом пользователя, в зависимости от дизайна интерфейса.

pending

Булево значение, которое true , если указанная amount ещё не окончательно определена. Это может использоваться для отображения таких элементов, как стоимость доставки или налога, которые зависят от выбора адреса доставки, варианта доставки и так далее. Агент пользователя может отображать эту информацию, но это не обязательно.

error Необязательно Устаревшее Нестандартное

Строка, определяющая сообщение об ошибке, которое должно быть отображено пользователю. При вызове updateWith(), включая error в обновлённые данные, агент пользователя отобразит текст в качестве общего сообщения об ошибке. Для ошибок, относящихся к полю адреса, используйте поле shippingAddressErrors.

modifiers Необязательно

Массив Array объектов PaymentDetailsModifier, свойства которых описаны в PaymentRequestEvent.modifiers.

Например, вы можете использовать его для корректировки общей суммы оплаты на основе выбранного способа оплаты («скидка 5% за наличные!»).

shippingAddressErrors Необязательно Устаревшее Нестандартное

Объект, содержащий сообщение об ошибке для каждого свойства адреса доставки, который не удалось проверить.

shippingOptions Необязательно Устаревшее Нестандартное

Массив объектов, каждый из которых описывает один доступный вариант доставки, из которого пользователь может выбрать.

total Необязательно

Объект с теми же свойствами, что и объекты в displayItems, предоставляющий обновлённую общую сумму оплаты. Убедитесь, что это равно сумме всех элементов в displayItems. Это не рассчитывается автоматически. Вы должны обновить это значение каждый раз, когда изменяется общая сумма долга. Это даёт вам гибкость в том, как обрабатывать такие вещи, как налог, скидки и другие корректировки общей стоимости.

Ничего (undefined).