Дополнительные данные
Дополнительный параметр 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
}
]
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 |