Initiate a wire transfer
This endpoint allows you to initiate a wire transfer from your account.
Body
Required
-
Amount of the wire transfer, in the smallest unit of the instructed currency.
Minimum value is
1
. -
Currency of the wire transfer. An exchange rate will be applied if the currency differs from the currency of the local account.
Format should match the following pattern:
^[A-Z]{3}$
. -
Existing IBAN to be used as the source of the wire transfer. Can be the main IBAN of an account or a virtual IBAN.
Format should match the following pattern:
^[A-Z]{2}[0-9]{2}[a-zA-Z0-9]{1,30}$
. -
Information regarding the beneficiary of this wire transfer.
-
Purpose of this wire transfer.
Values are
goods_purchase
orservices_purchase
. -
Message attached to this wire transfer, visible to all involved parties.
Minimum length is
10
, maximum length is140
. -
Internal note attached to this wire transfer, visible only in your Memo Bank workspace.
Minimum length is
1
, maximum length is3000
. -
Custom identifier that will be attached to the transaction resulting from this wire transfer. It will not be transmitted nor visible in your Memo Bank workspace. It can only be retrieved or used to search for transactions via Memo Bank API.
Minimum length is
1
, maximum length is256
. -
Custom metadata that will be attached to the transaction resulting from this wire transfer. It will not be transmitted nor visible in your Memo Bank workspace and can only be retrieved via API.
Minimum length is
1
, maximum length is2048
.
curl \
--request POST 'https://api.memo.bank/v2/wire_transfers' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{"instructed_amount":500,"instructed_currency":"EUR","local_iban":"FR6430003000509825397888D64","beneficiary":{"name":"John Doe","account_identifier":{"type":"iban_and_bic","iban":"FR2512739000308553756377J95","bic":"MEMOFRP2XXX"},"bank_country":"FR","address":{"street":"rue de la Boétie","postal_code":"75008","city":"Paris","country":"FR"},"type":"person","lei":"969500151TTK0D1U6N42"},"purpose":"goods_purchase","message":"invoice no12345","internal_note":"phone bill","custom_id":"637406efda8534de8c0e","custom_metadata":"This is some metadata"}'
{
"instructed_amount": 500,
"instructed_currency": "EUR",
"local_iban": "FR6430003000509825397888D64",
"beneficiary": {
"name": "John Doe",
"account_identifier": {
"type": "iban_and_bic",
"iban": "FR2512739000308553756377J95",
"bic": "MEMOFRP2XXX"
},
"bank_country": "FR",
"address": {
"street": "rue de la Boétie",
"postal_code": "75008",
"city": "Paris",
"country": "FR"
},
"type": "person",
"lei": "969500151TTK0D1U6N42"
},
"purpose": "goods_purchase",
"message": "invoice no12345",
"internal_note": "phone bill",
"custom_id": "637406efda8534de8c0e",
"custom_metadata": "This is some metadata"
}
{
"id": "61b05c4f-3f72-4951-8c30-a2a9faaa5184",
"reference": "ab004cfc-99fb-4ba9-bc9c-70982f853cb1",
"instructed_amount": 500,
"instructed_currency": "EUR",
"account_id": "708683cb-60f6-464a-a62f-be2e339c34aa",
"local_iban": "FR6430003000509825397888D64",
"beneficiary_account_identifier": {
"type": "iban_and_bic",
"iban": "FR2512739000308553756377J95",
"bic": "MEMOFRP2XXX"
},
"message": "invoice no12345",
"internal_note": "phone bill",
"uetr": "62dacdad-b003-4738-b21d-29fbfca5d1ea",
"custom_id": "637406efda8534de8c0e",
"custom_metadata": "This is some metadata",
"status": "failed",
"failure_code": "insufficient_funds"
}