> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ebury.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Multipayment models

## NewMultiPaymentItem

Every payment instruction to be submitted.

**Fields**

<ParamField body="account_number" type="string" required>
  Account number
</ParamField>

<ParamField body="bank_address" type="string" required>
  The bank address of the beneficiary
</ParamField>

<ParamField body="bank_code" type="string" required>
  The bank code of the beneficiary (UK sort code, US ABA/FedWire, etc.)
</ParamField>

<ParamField body="bank_country" type="string" required>
  The bank country of the beneficiary in ISO 3166-1 format (two character alpha code)
</ParamField>

<ParamField body="bank_name" type="string" required>
  Name of the bank account holder
</ParamField>

<ParamField body="beneficiary_address" type="string">
  The beneficiary address (deprecated)\*
</ParamField>

<ParamField body="beneficiary_street_name" type="string">
  The street name of the beneficiary.\*
</ParamField>

<ParamField body="beneficiary_building_number" type="string">
  The building number of the beneficiary.\*
</ParamField>

<ParamField body="beneficiary_floor" type="string">
  The floor of the beneficiary.\*
</ParamField>

<ParamField body="beneficiary_apartment_office_number" type="string">
  The apartment/office number of the beneficiary.\*
</ParamField>

<ParamField body="beneficiary_city" type="string" required>
  The city of the beneficiary.\*
</ParamField>

<ParamField body="beneficiary_state_region" type="string">
  The state/region of the beneficiary.\*
</ParamField>

<ParamField body="beneficiary_post_code" type="string">
  The postcode of the beneficiary.\*
</ParamField>

<ParamField body="beneficiary_country" type="string" required>
  The beneficiary country in ISO 3166-1 format (two character alpha code)
</ParamField>

<ParamField body="beneficiary_name" type="string" required>
  The beneficiary name
</ParamField>

<ParamField body="beneficiary_reference" type="string">
  Permanent reference to add to a beneficiary for all future payments.
</ParamField>

<ParamField body="direction" type="string" required>
  Acceptable values:

  * `buy`
  * `sell`
</ParamField>

<ParamField body="iban" type="string" required />

<ParamField body="inn" type="string">
  Unique Taxpayer Personal Identification Number for legal entities registered in Russia.
</ParamField>

<ParamField body="kio" type="string">
  Tax ID for foreign legal entities in Russia.
</ParamField>

<ParamField body="payment_currency" type="string" required>
  Buy currency code
</ParamField>

<ParamField body="payment_amount" type="number" required>
  Buy amount
</ParamField>

<ParamField body="payment_reference" type="string" required>
  Payment reference
</ParamField>

<ParamField body="purpose_of_payment" type="string">
  The [purpose of payment](#purposeofpayment) is mandatory when the beneficiary account has specific currency types. See the section [PurposeOfPayment](#purposeofpayment) for the currencies and their acceptable values.
</ParamField>

<ParamField body="reason_for_trade" type="string" required>
  Reason for trade. See [ReasonForTradeValues](#reasonfortradevalues) for acceptable values.
</ParamField>

<ParamField body="russian_central_bank_account" type="string">
  20-digit code for Russian banks.
</ParamField>

<ParamField body="swift_code" type="string" required />

<ParamField body="trade_type" type="string" required>
  Type of trade. Acceptable values:

  * `spot`
</ParamField>

<ParamField body="value_date" type="string" required>
  Date of the payment
</ParamField>

<ParamField body="vo" type="string">
  Code of currency transaction established by the Central Bank of Russia to describe the purpose of the payment.
</ParamField>

\* This field and the related rule becomes operational from October 2024. Further communication will follow over emails. Please note, it does not apply to Ebury Mass Payments customers in Production.
