Skip to main content
PUT
/
beneficiaries
/
{beneficiaryId}
Update Beneficiary
curl --request PUT \
  --url https://api.rolla.xyz/api/v1/external/beneficiaries/{beneficiaryId} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "currency": "NGN",
  "label": "<string>",
  "account_name": "JOHN DOE",
  "account_number": "0123456789",
  "bank_name": "Access Bank",
  "bank_code": "000014",
  "bank_address": {
    "street": "270 Park Ave",
    "city": "New York",
    "state": "NY",
    "postalCode": "10017",
    "country": "US"
  },
  "swift_code": "<string>",
  "email": "jsmith@example.com",
  "contact_person": "<string>",
  "beneficiary_address": {
    "street": "123 Main St",
    "city": "New York",
    "state": "NY",
    "postalCode": "10001",
    "country": "US"
  },
  "withdrawal_method": "domestic_wire",
  "routing_number": "<string>",
  "wallet_address": "<string>",
  "wallet_chain": "<string>",
  "intermediary_bank_name": "<string>",
  "intermediary_bank_routing_number": "<string>",
  "recipient_business_id": "d4e5f6a7-b8c9-0123-defa-456789012345"
}
'
{
  "success": true,
  "message": "Beneficiary updated successfully",
  "data": {
    "beneficiary": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "currency": "NGN",
      "label": "Office rent",
      "account_name": "JOHN DOE",
      "account_number": "0123456789",
      "bank_name": "Access Bank",
      "bank_code": "000014",
      "bank_address": "<string>",
      "swift_code": "<string>",
      "email": "jsmith@example.com",
      "contact_person": "<string>",
      "beneficiary_address": "<string>",
      "withdrawal_method": "domestic_wire",
      "routing_number": "<string>",
      "wallet_address": "<string>",
      "wallet_chain": "<string>",
      "intermediary_bank_name": "<string>",
      "intermediary_bank_routing_number": "<string>",
      "recipient_business_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  }
}
Update the details of an existing saved beneficiary.

​
Example Request

curl -X PUT "https://api.rolla.xyz/api/v1/external/beneficiaries/c3d4e5f6-a7b8-9012-cdef-123456789012" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "currency": "NGN",
    "label": "Updated label",
    "account_name": "JOHN DOE",
    "account_number": "0123456789",
    "bank_name": "Access Bank",
    "bank_code": "000014",
    "email": "john.updated@example.com"
  }'

​
Example Response

{
  "status": 200,
  "success": true,
  "message": "Beneficiary updated successfully",
  "data": {
    "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "currency": "NGN",
    "label": "Updated label",
    "account_name": "JOHN DOE",
    "account_number": "0123456789",
    "bank_name": "Access Bank",
    "bank_code": "000014",
    "withdrawal_method": null,
    "email": "john.updated@example.com",
    "created_at": "2024-01-10T08:00:00.000Z",
    "updated_at": "2024-01-15T12:00:00.000Z"
  }
}
The same validation rules apply as when creating a beneficiary. See the Create Beneficiary endpoint for required fields by withdrawal method.

Authorizations

​
X-API-Key
string
header
required

Your Rolla API key

Path Parameters

​
beneficiaryId
string<uuid>
required

Beneficiary UUID

Body

application/json
​
currency
string
required

Currency code (e.g., NGN, USD)

Example:

"NGN"

​
label
string

Friendly label for the beneficiary

​
account_name
string

Account holder name

Maximum string length: 100
Example:

"JOHN DOE"

​
account_number
string

Bank account number

Maximum string length: 50
Example:

"0123456789"

​
bank_name
string

Bank name

Maximum string length: 100
Example:

"Access Bank"

​
bank_code
string

Bank code (required for NGN beneficiaries)

Maximum string length: 20
Example:

"000014"

​
bank_address
object

Bank's physical address. Required for USD domestic and international wire transfers.

​
swift_code
string

SWIFT/BIC code (required for international wire)

Maximum string length: 20
​
email
string<email>

Beneficiary email

Maximum string length: 100
​
contact_person
string

Contact person name

Maximum string length: 100
​
beneficiary_address
object

Beneficiary's physical address. Required for USD domestic and international wire transfers.

​
withdrawal_method
enum<string>

Withdrawal method

Available options:
domestic_wire,
international_wire,
crypto_usdt,
crypto_usdc,
rolla_transfer
​
routing_number
string

Routing number (for US wires)

Maximum string length: 20
​
wallet_address
string

Crypto wallet address (for crypto withdrawals)

​
wallet_chain
string

Blockchain network (for crypto withdrawals)

Maximum string length: 50
​
intermediary_bank_name
string

Intermediary bank name

Maximum string length: 255
​
intermediary_bank_routing_number
string

Intermediary bank routing number

Maximum string length: 50
​
recipient_business_id
string<uuid>

Required for rolla_transfer. The UUID of the destination Rolla business.

Example:

"d4e5f6a7-b8c9-0123-defa-456789012345"

Response

Beneficiary updated successfully

​
success
boolean
Example:

true

​
message
string
Example:

"Beneficiary updated successfully"

​
data
object