Sign in
Beneficiaries

Updates a beneficiary.

<b>Authorization</b>: End user token is required.

<b>User permissions required</b>: CanEditBeneficiaries

put/api/v1/beneficiaries/{id}

Request

  • Base URL: https://api.nofrixion.com
  • URL: https://api.nofrixion.com/api/v1/beneficiaries/{id}
  • Auth: API key in header Authorization

Path parameters

idstring uuid required

The ID of the beneficiary to update.

Request body

sourceAccountIDsstring[] nullable

ID of the accounts which are authorised to act as a source for the beneficiary.

namestring nullable

The descriptive name for the beneficiary.

currency'NONE' | 'GBP' | 'EUR' | 'USD' | 'AUD' | 'BGN' | 'CAD' | 'CZK' | 'DKK' | 'HUF' | 'ISK' | 'CHF' | 'NOK' | 'PLN' | 'RON' | 'AED' | 'CNH' | 'HKD' | 'ILS' | 'JPY' | 'MXN' | 'NZD' | 'SAR' | 'SEK' | 'SGD' | 'TRY' | 'ZAR' | 'BTC' nullable
theirReferencestring nullable

The default reference that will be used by default as TheirReference when creating payouts to this beneficiary if no TheirReference is specified for the payout.

Response

The updated beneficiary record.

idstring uuid
merchantIDstring uuid

Gets or Sets the merchant id.

namestring required

The descriptive name for the beneficiary.

currency'NONE' | 'GBP' | 'EUR' | 'USD' | 'AUD' | 'BGN' | 'CAD' | 'CZK' | 'DKK' | 'HUF' | 'ISK' | 'CHF' | 'NOK' | 'PLN' | 'RON' | 'AED' | 'CNH' | 'HKD' | 'ILS' | 'JPY' | 'MXN' | 'NZD' | 'SAR' | 'SEK' | 'SGD' | 'TRY' | 'ZAR' | 'BTC' required

Gets or Sets the currency.

approvalCallbackUrlstring nullable
isEnabledboolean
canAuthoriseboolean

True if the beneficiary can be authorised by the user who loaded it.

canUpdateboolean

True if the beneficiary can be updated by the user who loaded it.

hasCurrentUserAuthorisedboolean

True if the beneficiary was loaded for a user and that user has already authorised the latest version of the beneficiary.

authorisersRequiredCountinteger

The number of authorisers required for this beneficiary. Is determined by business settings on the source account and/or merchant.

authorisersCompletedCountinteger

The number of distinct authorisers that have authorised the beneficiary.

authenticationMethodsstring[] nullable

A list of authentication types allowed to authorise the payout.

createdByEmailAddressstring nullable
noncestring nullable
insertedstring date-time
lastUpdatedstring date-time
lastAuthorisedstring date-time nullable
theirReferencestring nullable

The reference that will be used by default as TheirReference when creating payouts to this beneficiary if no TheirReference is specified for the payout.

Changes

No recorded changes to this endpoint across all 2 revisions of this API.