Transaction creation

General principle

The request body for creating a transaction has the same shape for every type, but the valid values and combinations of the paymentType, sourceRequisit, and destinationRequisit fields depend on the value of the type field. Below is how to correctly build a request for each type.

---

Type EXCHANGE — currency exchange

How to build the request:

1. Set type: "EXCHANGE".
2. paymentType must always be set to "EMPTY".
3. sourceRequisit.account and destinationRequisit.account must reference two different accounts that are in different currencies. The same account cannot be used for both source and destination.

Example of a valid request:

{
  "customerId": "DHgsZkC-rvmu-0HYxwr1B65nD",
  "paymentType": "EMPTY",
  "type": "EXCHANGE",
  "sourceRequisit": {
    "account": "Usco8JZs2Nfo"
  },
  "destinationRequisit": {
    "account": "EOdGnNNGgjbd"
  },
  "amount": {
    "units": "1",
    "nanos": 0
  }
}

---

Type TRANSFER — transfer between own accounts

How to build the request:

1. Set type: "TRANSFER".
2. paymentType must always be set to "EMPTY".
3. sourceRequisit.account and destinationRequisit.account must reference two different accounts that are in the same currency.
4. Both accounts must belong to the same customerId.

Example of a valid request:

{
  "customerId": "DHgsZkC-rvmu-0HYxwr1B65nD",
  "paymentType": "EMPTY",
  "type": "TRANSFER",
  "sourceRequisit": {
    "account": "Usco8JZs2Nfo"
  },
  "destinationRequisit": {
    "account": "EOdGnNNGgjbd"
  },
  "amount": {
    "units": "1",
    "nanos": 0
  }
}

---

Type WITHDRAW — withdrawal to a beneficiary

How to build the request:

1. Set type: "WITHDRAW".
2. paymentType cannot be "EMPTY" — it must be set to the value matching the support rail (payment system) of the beneficiary's account, for example "SWIFT".
3. destinationRequisit must always be described via the beneficiar field (not account) — it holds the recipient's account.

Example of a valid request:

{
  "customerId": "DHgsZkC-rvmu-0HYxwr1B65nD",
  "paymentType": "SWIFT",
  "type": "WITHDRAW",
  "sourceRequisit": {
    "account": "Usco8JZs2Nfo"
  },
  "destinationRequisit": {
    "beneficiar": "EOdGnNNGgjbd"
  },
  "amount": {
    "units": "1",
    "nanos": 0
  }
}