PUT
/
api
/
v1
/
beneficiaries
/
{beneficiary_id}
Update Beneficiary
curl --request PUT \
  --url http://localhost:8080/api/v1/beneficiaries/{beneficiary_id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_number": "<string>",
  "address": "<string>",
  "bank_address": "<string>",
  "bank_name": "<string>",
  "bic": "<string>",
  "city": "<string>",
  "country_code": "<string>",
  "display": true,
  "iban": "<string>",
  "name": "<string>",
  "postal_code": "<string>",
  "routing_number": "<string>",
  "swift_code": "<string>"
}
'
{
  "client_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "display": true,
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "updated_at": "2023-11-07T05:31:56Z",
  "account_number": "<string>",
  "address": "<string>",
  "bank_address": "<string>",
  "bank_name": "<string>",
  "bic": "<string>",
  "city": "<string>",
  "country_code": "<string>",
  "iban": "<string>",
  "postal_code": "<string>",
  "routing_number": "<string>",
  "swift_code": "<string>"
}

Path Parameters

​
beneficiary_id
string<uuid>
required

Beneficiary UUID

Body

application/json

Request to update an existing beneficiary Note: Nested Option fields (Option<Option>) don't support derive(Validate), so validation for IBAN, BIC, etc. is done manually via validate() method

​
account_number
string | null
​
address
string | null
​
bank_address
string | null
​
bank_name
string | null
​
beneficiary_type
null | enum<string>

Beneficiary Type - Individual person or company

Available options:
PERSON,
COMPANY
​
bic
string | null
​
city
string | null
​
country_code
string | null
​
display
boolean | null
​
iban
string | null
​
name
string | null
​
postal_code
string | null
​
routing_number
string | null
​
swift_code
string | null

Response

Beneficiary updated successfully

Beneficiary - Payment recipient entity

​
beneficiary_type
enum<string>
required

Beneficiary Type - Individual person or company

Available options:
PERSON,
COMPANY
​
client_id
string<uuid>
required
​
created_at
string<date-time>
required
​
display
boolean
required

Whether beneficiary is displayed to users

​
id
string<uuid>
required
​
name
string
required

Beneficiary name (person or company name)

​
updated_at
string<date-time>
required
​
account_number
string | null

Bank account number (non-SEPA)

​
address
string | null
​
bank_address
string | null

Bank address

​
bank_name
string | null

Bank name

​
bic
string | null

Bank Identifier Code (SEPA)

​
city
string | null
​
country_code
string | null

ISO 3166-1 alpha-3 country code

​
iban
string | null

International Bank Account Number (SEPA)

​
postal_code
string | null
​
routing_number
string | null

US ABA routing number

​
swift_code
string | null

SWIFT code for international transfers