Дополнительные данные

Дополнительный параметр reservation_data можно передать в запросе на создание покупки.

Пример:

{
  "request": {
    "response_url": "https://site.com/responsepage/",
    "order_id": "test_reservation_data_12345",
    "order_desc": "Test payment",
    "currency": "UZS",
    "amount": "100",
    "signature": "dcf5a9a582872bf0ba89bb77a25c3894671b423a",
    "merchant_id": "4056281",
    "reservation_data": "ewogICJwaG9uZW1vYmlsZSI6ICIrMTIzNDU2NzgiLAogICJjdXN0b21lcl9hZGRyZXNzIjogIjE1IGdhbm5ldCBzdHJlZXQgZWxzcGFyayIsCiAgImN1c3RvbWVyX2NvdW50cnkiOiAiVVMiLAogICJjdXN0b21lcl9zdGF0ZSI6ICJOWSIsCiAgImN1c3RvbWVyX25hbWUiOiAiQnJhbmRvbiBOeWF0aGkiLAogICJjdXN0b21lcl9jaXR5IjogIk5ldyBZb3JrIiwKICAiY3VzdG9tZXJfemlwIjogIjE0MDEiLAogICJhY2NvdW50IjogImlkMzI2NDg0ODAiCn0="
  }
}

reservation_data – это данные в формате JSON, закодированные с помощью алгоритма BASE64. Они имеют следующую структуру:

JSON:

{
  "phonemobile": "+12345678",
  "customer_address": "15 gannet street elspark",
  "customer_country": "US",
  "customer_state": "NY",
  "customer_name": "Brandon Nyathi",
  "customer_city": "New York",
  "customer_zip": "1401",
  "account": "id32648480",
  "uuid": "00002415-0000-1000-8000-00805F9B34FB"
}

Все параметры должны быть буквенно-цифровыми и содержать латинские буквы, цифры и символы-разделители

Название параметра                        обязательный Тип Описание Пример
phonemobile no AN(16) Мобильный телефон клиента +12345678
customer_address no AN(1024) Адрес клиента 15 gannet street elspark
customer_country no AN(2) ISO-код страны клиента Великобритания
customer_name no AN(1024) Имя плательщика Брэндон Ньяти
customer_city no AN(1024) Город плательщика Нью-Йорк
customer_zip no AN(250) Почтовый индекс 1401
account no AN(250) Идентификатор клиентского счета в системе продавца id32648480
uuid no AN(250) Device UUID 00002415-0000-1000-8000-00805F9B34FB
settlement_id no AN(32) ID, который будет передан в отчеты по расчетам для автоматизации процесса сверки SettlementID::12311233443
3ds_mandatory no boolean Параметр для принудительного проведения платежа без 3DS. Может использоваться только после одобрения командой по рискам Payme . true или false
fields_custom[] JSON-объект « » отсутствует JSON-список « » с дополнительными полями, которые должны отображаться при оформлении заказа
products[] no JSON-объект JSON-список продуктов, подлежащих фискализации

fields_custom — это объект JSON, который позволяет добавлять настраиваемые поля ввода на страницу оформления заказа

"fields_custom": [
    {
      "name": "id-1",
      "label": "label1",
      "value": "1",
      "valid": {
        "pattern": "^[0-9]+$",
        "max_length": 222,
        "min_length": 10
      },
      "readonly": false,
      "required": true,
      "type": "input",
      "p": 1
    },
    {
      "name": "id-2",
      "label": "label2",
      "value": "",
      "p": 2
    },
    {
      "name": "id-3",
      "label": "label3",
      "type": "checkbox",
      "required": true,
      "p": 3
    }
  ]

products — это объект JSON, содержащий данные, подлежащие фискализации

    "products": [
        {
            "id": 1,
            "name": "Product A",
            "price": 100.00,
            "quantity": 2,
            "vat_percent": 20,
            "code": "00702001001000001",
            "units": 1,
            "discount": 10.00,
            "package_code": "5678",
            "total_amount": 190.00
        },
        {
            "id": 1,
            "name": "Product B",
            "price": 100.00,
            "quantity": 2,
            "vat_percent": 20,
            "code": "00702001001000001",
            "units": 1,
            "discount": 10.00,
            "package_code": "5679",
            "total_amount": 190.00
        }
    ]
Описание JSON-объекта products:

Название параметра                        обязательный Тип Описание Пример
id no number ID of product 1
discount no number Скидка в тийнах в зависимости от количества товаров или услуг 100.20
name no string Название продукта Прокат скутеров
price no number Цена за единицу товаров или услуг в тийнах 122.56
quantity no number Количество товаров или услуг 2
code no number Идентификационный код продукта и услуги 00702001001000001
units no number Unit code 241092
vat_percent no number Процент НДС, уплаченного за этот товар 20
package_code no number Код упаковки продукта 123456
total_amount no number Общая сумма всех товаров и услуг 245.12