Updated REST-API-ru.md

doc/REST-API-ru.md

@@ -221,6 +221,90 @@ deal:
     comments: <string>
 ```
 
+#### Новая сделка (ордер)
+
+Ордер создается без указания адреса платежа (поле `payment`). Адрес платежа связан с исходными данными ордера. Зная исходные данные ордера можно вычислить адрес платежа. 
+
+Адрес платежа создается модулем сделок. 
+
+**Пример:**
+
+Минимально необходимый набор данных для создания ордера (в формате JSON) предоставлен ниже:
+
+Запрос:
+
+~~~http request
+POST /api/v1/deal
+~~~
+
+Тело запроса 
+```json
+{
+  "order": "create",
+  "type": "Prepaid",
+  "at": "http://placard.zr-code.com",
+  "date": "2022-04-11 11:14:46 UTC",
+  "seller": {
+    "address": "n2f3cbeUUFhbz6mFLpDUzMnrt72sPu7WQK"
+  },
+  "customer": {
+    "address": "2N3oefVeg6stiTb5Kh3ozCSkaqmx91FDbsm"
+  },
+  "payment": {
+    "until": "2022-04-12 11:14:46 UTC",
+    "sum": 0.00001
+  }
+}
+```
+
+Ответ:
+
+~~~json
+{
+  "id": "AEEAB-PEE95-O6F30-S68A8-TC55A-O3B7D-L98370", 
+  "action": "Created", 
+  "result": {
+    "success": true, 
+    "message": "New deal submitted"
+  }, 
+  "payload": "LS0tLS1CRUdJTiBQR1AgU0lHTkVEIE1FU1NBR0UtLS0tLQpIYXNoOiBTSEE1MTIKCmRlYWw6CiAgb3JkZXI6IENyZWF0ZWQKICB0eXBlOiBQcmVwYWlkCiAgYXQ6IGh0dHA6Ly9wbGFjYXJkLnpyLWNvZGUuY29tCiAgZGF0ZTogMjAyMi0wNC0xMSAxMToxNDo0NiBVVEMKICBzZWxsZXI6CiAgICBhZGRyZXNzOiBuMmYzY2JlVVVGaGJ6Nm1GTHBEVXpNbnJ0NzJzUHU3V1FLCiAgICByYXRpbmc6IDAsIDAlCiAgY3VzdG9tZXI6CiAgICBhZGRyZXNzOiAyTjNvZWZWZWc2c3RpVGI1S2gzb3pDU2thcW14OTFGRGJzbQogICAgcmF0aW5nOiAwLCAwJQogIHBheW1lbnQ6CiAgICB1bnRpbDogMjAyMi0wNC0xMiAxMToxNDo0NiBVVEMKICAgIGFkZHJlc3M6IDJONmFidjNxaGdIUXh2bnRmRHptbWk0a0htMTRUYWRvQnB1CiAgICBzdW06IDAuMDAwMDEgdEJUQwogIGZlZWRiYWNrOgogICAgbGVhdmUtYmVmb3JlOiAyMDIyLTA0LTEyIDExOjE0OjQ2IFVUQwotLS0tLUJFR0lOIFBHUCBTSUdOQVRVUkUtLS0tLQpWZXJzaW9uOiBjYwoKd3B3RUFRRUtBQVlGQW1KVURid0FDZ2tRN0lqUjIwSkJpemVCckFRQWp0UlU5R3IySm1qdUhLTHhaejQrVWMzQwp2cUFzem1JcjhZRUdRUWZKS3o3SjJsd1U0ZkNOaVByZ29yQTdIdVRGa1Bqd0JrN0N0MHBOZlQwWmpxYTVYWXk5Cml1d01hRkVsM1dmVUQ0MlQxQVFWUDhCbUp6RmtxUXdVSE81dWtDS1RpaTViK3VHVVIvZzJETStFOXVBb3ZYWEYKZ3M5NldWVlJzNGg5YWdCektPTT0KPW4razcKLS0tLS1FTkQgUEdQIFNJR05BVFVSRS0tLS0t"
+}
+~~~
+
+Расшифровка `payload`:
+
+~~~yaml
+-----BEGIN PGP SIGNED MESSAGE-----
+Hash: SHA512
+
+deal:
+  order: Created
+  type: Prepaid
+  at: http://placard.zr-code.com
+  date: 2022-04-11 11:14:46 UTC
+  seller:
+    address: n2f3cbeUUFhbz6mFLpDUzMnrt72sPu7WQK
+    rating: 0, 0%
+  customer:
+    address: 2N3oefVeg6stiTb5Kh3ozCSkaqmx91FDbsm
+    rating: 0, 0%
+  payment:
+    until: 2022-04-12 11:14:46 UTC
+    address: 2N6abv3qhgHQxvntfDzmmi4kHm14TadoBpu
+    sum: 0.00001 tBTC
+  feedback:
+    leave-before: 2022-04-12 11:14:46 UTC
+-----BEGIN PGP SIGNATURE-----
+Version: cc
+
+wpwEAQEKAAYFAmJUDbwACgkQ7IjR20JBizeBrAQAjtRU9Gr2JmjuHKLxZz4+Uc3C
+vqAszmIr8YEGQQfJKz7J2lwU4fCNiPrgorA7HuTFkPjwBk7Ct0pNfT0Zjqa5XYy9
+iuwMaFEl3WfUD42T1AQVP8BmJzFkqQwUHO5ukCKTii5b+uGUR/g2DM+E9uAovXXF
+gs96WVVRs4h9agBzKOM=
+=n+k7
+-----END PGP SIGNATURE-----
+~~~
+
 ### Пользователь
 
 #### Помощь