Create a formance bank account object. This object will not be forwarded to the connector until you called the forwardBankAccount method.

POST /api/payments/v3/bank-accounts

Try it

Create a formance bank account object. This object will not be forwarded to the connector until you called the forwardBankAccount method.

cURL

curl --request POST \
  --url http://localhost/api/payments/v3/bank-accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "accountNumber": "<string>",
  "iban": "<string>",
  "swiftBicCode": "<string>",
  "country": "<string>",
  "metadata": {}
}
'

201

{
  "data": "<string>"
}

Authorizations

Authorization · string · header · required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

name · string · required

accountNumber · string

iban · string

swiftBicCode · string

country · string

metadata · object

Show child attributes

metadata. {key} · string

Response

201

application/json

Created

data · string · required

The ID of the created bank account