MSPF-191: Describe amount and currency more thoroughly (#41)

spec/definitions/Invoice.yaml

@@ -28,12 +28,16 @@ allOf:
         type: string
         format: date-time
       amount:
-        description: Стоимость предлагаемых товаров или услуг
+        description: |
+          Стоимость предлагаемых товаров или услуг, в минорных денежных единицах,
+          например в копейках в случае указания российских рублей в качестве валюты.
         type: integer
         format: int64
         minimum: 1
       currency:
-        description: Валюта
+        description: |
+          Валюта, символьный код согласно
+          [RFC 4217](http://www.iso.org/iso/home/standards/currency_codes.htm).
         type: string
       metadata:
         description: Связанные с инвойсом метаданные

spec/definitions/InvoiceParams.yaml

@@ -12,12 +12,16 @@ properties:
     type: integer
     format: int32
   amount:
-    description: Стоимость предлагаемых товаров или услуг
+    description: |
+      Стоимость предлагаемых товаров или услуг, в минорных денежных единицах,
+      например в копейках в случае указания российских рублей в качестве валюты.
     type: integer
     format: int64
     minimum: 1
   currency:
-    description: Валюта
+    description: |
+      Валюта, символьный код согласно
+      [RFC 4217](http://www.iso.org/iso/home/standards/currency_codes.htm).
     type: string
   metadata:
     description: Метаданные, которые необходимо связать с инвойсом

spec/definitions/PaymentGeoStat.yaml

@@ -14,7 +14,9 @@ properties:
     type: integer
     format: int32
   currency:
-    description: Валюта платежей
+    description: |
+      Валюта платежей, символьный код согласно
+      [RFC 4217](http://www.iso.org/iso/home/standards/currency_codes.htm).
     type: string
   profit:
     description: Прибыль магазина

spec/definitions/PaymentRevenueStat.yaml

@@ -9,7 +9,9 @@ properties:
     description: Смещение сегмента выборки
     type: integer
   currency:
-    description: Валюта платежей
+    description: |
+      Валюта платежей, символьный код согласно
+      [RFC 4217](http://www.iso.org/iso/home/standards/currency_codes.htm).
     type: string
   profit:
     description: Прибыль магазина