API status

All test related paths.

post

Trigger a bank transaction

Trigger a bank transaction for testing purposes. This can be used to simulate a money transfer for various flows which need cash settlements on one of our bank accounts.

accountobject

required

The Upvest account identification

amountstring

required

Pattern
^[0-9]{1,9}(\.[0-9]{2})?$
currencystring

required

Alphabetic three-letter ISO 4217 currency code.

  • EUR - Euro
Default
"EUR"
Enum
  • EUR
remittance_informationstring

Information supplied to enable the matching/reconciliation of an entry with the items that the payment is intended to settle, such as commercial invoices in an accounts' receivable system, in an unstructured form.

Pattern
^[0-9A-Za-z+?/\-:()\.,'; ]{0,140}$
Max Length
140
client_referencestring

required

Unique identification, as assigned by the initiating party, to unambiguously identify the transaction. This identification is passed on, unchanged, throughout the entire end-to-end chain. (also known as end-to-end-ID)

Pattern
^[0-9A-Za-z+?/\-:()\.,'; ]{0,35}$
Max Length
35
counterparty_namestring

required

The counterparty account owner

Pattern
^[0-9A-Za-z+?/\-:()\.,'; ]{0,140}$
Max Length
140
counterparty_accountobject

required

Unambiguous identification of the account of the counterparty of the bank transaction

counterparty_agentobject

Unambiguous identification of the agent of the counterparty of the bank transaction

virtual_bank_account_idstring

The ID of the virtual bank account to which you want to send the money.

Format
uuid

Responses

Request examples

{
  "account": {
    "iban": "NL70ABNA0106295004"
  },
  "amount": "13.37",
  "currency": "EUR",
  "client_reference": "client-reference",
  "remittance_information": "remittance-info",
  "counterparty_name": "counterparty-name",
  "counterparty_account": {
    "iban": "DE95500105173934555844"
  },
  "counterparty_agent": {
    "bic": "DEUTDEFF"
  },
  "virtual_bank_account_id": "f7b3b3b3-7b3b-4b3b-8b3b-3b3b3b3b3b3b"
}

Response examples

Bank Transaction

{
  "id": "6ffa6b16-2380-4e7a-88b2-ae625c8eef99",
  "bank_reference": "f2f0ef23-c68d-42c1-a744-8c86f471954b"
}