Skip to main content

Conversion

This method allows creating one or more documents of conversion between customers’ accounts.

Params​

A document array with the following attributes:

UniqueIdrequiredglobally unique identifier

An unique ID of the document in the external (caller) system (Guid).

DocumentNooptionalstring

A document number.

SourceAccountNumberoptionalstring

An account number of a currency to sell.

SourceCurrencyoptionalstring

A currency to sell.

DestinationAccountNumberoptionalstring

An account number of a currency to buy.

Amountoptionaldecimal number

An amount

Rateoptionaldecimal number

An exchange rate. Should be filled in case of using a conversion rate individually agreed with a Bank.

AdditionalInfooptionalstring

An additional info. Is not used for transfers in a national currency

POST api/documents/conversion
Content-Type: application/json
[
  {
    "UniqueId": "fdbf64d0-d481-426f-9799-9a6920728e0c",
    "DocumentNo": "sample string 2",
    "SourceAccountNumber": "sample string 3",
    "SourceCurrency": "sample string 4",
    "DestinationAccountNumber": "sample string 5",
    "DestinationCurrency": "sample string 6",
    "Amount": 7.0,
    "Rate": 8.0,
    "AdditionalInfo": "sample string 9"
  },
  {
    "UniqueId": "fdbf64d0-d481-426f-9799-9a6920728e0c",
    "DocumentNo": "sample string 2",
    "SourceAccountNumber": "sample string 3",
    "SourceCurrency": "sample string 4",
    "DestinationAccountNumber": "sample string 5",
    "DestinationCurrency": "sample string 6",
    "Amount": 7.0,
    "Rate": 8.0,
    "AdditionalInfo": "sample string 9"
  }
]

Response​

UniqueIdglobally unique identifier

An unique ID in the external system (Guid).

UniqueKeyinteger

An unique ID of the document in the business online.

ResultCodeinteger

A result code of an operation. (With a link to the ResultCode page). result code

Matchdecimal number

For the internal transfers a matched coefficient of provided recipient name. For legal entities a match of an owner of a provided IBAN to the entity name is being checked, while for the individuals - to the name and surname. A match coefficient in percent will be shown as a result of such a comparison.

[
  {
    "UniqueId": "93fb404b-5f8e-486b-8b35-610d71a41675",
    "UniqueKey": 2,
    "ResultCode": 1,
    "Match": 1.0
  },
  {
    "UniqueId": "93fb404b-5f8e-486b-8b35-610d71a41675",
    "UniqueKey": 2,
    "ResultCode": 1,
    "Match": 1.0
  }
]