Адрес оплаты

Интерфейс PaymentAddress API запросов платежа используется для хранения информации о доставке или адресе оплаты.

Полезно ознакомиться с материалами стандарта адресации S42 Всемирного почтового союза, которые предоставляют информацию об международных стандартах почтовых адресов.

PaymentAddress.addressLine Только для чтения Устарело Нестандартно

Массив строк, представляющий каждую строку адреса, не включенную в другие свойства. Точный размер и содержимое зависят от страны или местоположения и могут включать, например, название улицы, номер дома, номер квартиры, маршрут для сельского почтового отделения, описательные инструкции или номер почтового ящика.

PaymentAddress.country Только для чтения Устарело Нестандартно

Строка, указывающая страну расположения адреса, используя стандарт ISO-3166-1 alpha-2. Строка всегда задается в канонической форме заглавных букв. Некоторые примеры допустимых country значений: "US", "GB", "CN", или "JP".

PaymentAddress.city Только для чтения Устарело Нестандартно

Строка, содержащая часть адреса, относящуюся к городу или поселку.

PaymentAddress.dependentLocality Только для чтения Устарело Нестандартно

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

PaymentAddress.organization Только для чтения Устарело Нестандартно

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

PaymentAddress.phone Только для чтения Устарело Нестандартно

Строка, указывающая телефонный номер получателя или контактного лица.

PaymentAddress.postalCode Только для чтения Устарело Нестандартно

Строка, указывающая код, используемый юрисдикцией для маршрутизации почты, например, почтовый индекс в США или почтовый индекс в Индии.

PaymentAddress.recipient Только для чтения Устарело Нестандартно

Строка, содержащая имя получателя, покупателя или контактного лица по адресу оплаты.

PaymentAddress.region Только для чтения Устарело Нестандартно

Строка, содержащая высший административный подраздел страны, например, штат, провинция, область или префектура.

PaymentAddress.sortingCode Только для чтения Устарело Нестандартно

Строка, предоставляющая почтовый сортировочный код, такой как используется во Франции.

PaymentAddress.toJSON() Устарело Нестандартно

Стандартный сериализатор, возвращающий JSON-представление свойств объекта PaymentAddress.

В следующем примере используется конструктор PaymentRequest() для создания нового запроса платежа, который принимает три объекта в качестве параметров — один содержит данные о способах оплаты, которые можно использовать для оплаты, один содержит данные о фактическом заказе (такие как приобретенные товары и варианты доставки), и необязательный объект, содержащий дополнительные параметры.

Первый из этих трех (supportedInstruments в примере ниже) содержит свойство data, которое должно соответствовать структуре, определенной способом оплаты.

const supportedInstruments = [
  {
    supportedMethods: "https://example.com/pay",
  },
];

const details = {
  total: { label: "Donation", amount: { currency: "USD", value: "65.00" } },
  displayItems: [
    {
      label: "Original donation amount",
      amount: { currency: "USD", value: "65.00" },
    },
  ],
  shippingOptions: [
    {
      id: "standard",
      label: "Standard shipping",
      amount: { currency: "USD", value: "0.00" },
      selected: true,
    },
  ],
};

const options = { requestShipping: true };

async function doPaymentRequest() {
  const request = new PaymentRequest(supportedInstruments, details, options);
  // Add event listeners here.
  // Call show() to trigger the browser's payment flow.
  const response = await request.show();
  // Process payment.
  const json = response.toJSON();
  const httpResponse = await fetch("/pay/", { method: "POST", body: json });
  const result = httpResponse.ok ? "success" : "failure";

  await response.complete(result);
}
doPaymentRequest();

После того, как поток оплаты был запущен с помощью PaymentRequest.show() и обещание успешно разрешилось, объект PaymentResponse, доступный из выполненного обещания (instrumentResponse выше), будет иметь свойство PaymentResponse.details, содержащее детали ответа. Это должно соответствовать структуре, определенной поставщиком способа оплаты.