PUT
/
customers
/
{customerID}
/
liquidation_addresses
/
{liquidationAddressID}
Update a Liquidation Address
curl --request PUT \
  --url https://api.bridge.xyz/v0/customers/{customerID}/liquidation_addresses/{liquidationAddressID} \
  --header 'Api-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "external_account_id": "<string>",
  "custom_developer_fee_percent": "0.1",
  "destination_ach_reference": "<string>",
  "destination_wire_message": "<string>",
  "destination_sepa_reference": "<string>",
  "destination_spei_reference": "<string>",
  "return_address": "<string>"
}'
{
  "id": "la_123",
  "chain": "ethereum",
  "customer_id": "cust_123",
  "external_account_id": "ext_123",
  "address": "0x4d0280da2f2fDA5103914bCc5aad114743152A9c",
  "currency": "usdc",
  "destination_payment_rail": "wire",
  "destination_currency": "usd",
  "destination_wire_message": "a wire message",
  "state": "active",
  "created_at": "2023-11-22T21:31:30.515Z",
  "updated_at": "2023-11-22T21:31:30.515Z"
}

Authorizations

​
Api-Key
string
header
required

Path Parameters

​
customerID
string
required

A UUID that uniquely identifies a resource

Required string length: 1 - 42
​
liquidationAddressID
string
required

A UUID that uniquely identifies a resource

Required string length: 1 - 42

Body

application/json

Liquidation Address details to be updated

​
external_account_id
string

An optional identifier for the external account you wish to associate with this liquidation schedule.

Note: Only one liquidation address can be associated with an external account per (customer, chain, currency).

​
custom_developer_fee_percent
string<number> | null

The developer fee percent that will be applied to this Liquidation Address or null to use the default fee. The value is a base 100 percentage, i.e. 10.2% is 10.2 in the API.

Example:

"0.1"

​
destination_ach_reference
string

A reference message to be sent with an ACH transaction. It can be at most 10 characters, A-Z, a-z, 0-9, and spaces.

Required string length: 1 - 10
​
destination_wire_message
string

A message to be sent with a wire transfer. It can have up to 140 characters.

Required string length: 1 - 256
​
destination_sepa_reference
string

A reference message to be sent with a SEPA transaction. We recommend you set a unique value to help you and your customers track payments end to end. It must be from 6 to 140 characters. The allowed characters are a-z, A-Z, 0-9, spaces, ampersand (&), hyphen (-), full stop (.), and solidus (/). If not populated, the default value is "Payment via Bridge {unique_token}".

Required string length: 6 - 140
​
destination_spei_reference
string

A payment reference message or remittance information to be included in a SPEI transaction. The allowed characters are alphanumeric a-z, A-Z, 0-9, and space

Required string length: 1 - 40
​
return_address
string

The crypto wallet address that Bridge will use to return funds to the customer in case of a failed transaction. This address must be on the same chain specified for the liquidation address. Please note, this functionality is not supported on Stellar.

Response

Updated Liquidation Address object

​
id
string
required

A UUID that uniquely identifies a resource

Required string length: 1 - 42
​
currency
enum<string>
required
Available options:
usdb,
usdc,
usdt,
dai,
pyusd,
eurc,
any
​
chain
enum<string>
required
Available options:
arbitrum,
avalanche_c_chain,
base,
ethereum,
optimism,
polygon,
solana,
stellar,
tron,
evm
​
customer_id
string
required

The ID of the customer who owns this liquidation address

Required string length: 1 - 42
​
external_account_id
string
required

External bank account to which Bridge will send the funds. The currency associated with the External Account must match the destination currency.

Required string length: 1 - 42
​
destination_payment_rail
enum<string>
required

The payment rail that Bridge will use to send funds to the customer.

Available options:
ach,
wire,
ach_push,
ach_same_day,
arbitrum,
avalanche_c_chain,
base,
ethereum,
fiat_deposit_return,
optimism,
polygon,
sepa,
solana,
spei,
stellar,
swift,
tron
​
destination_currency
enum<string>
required

The currency that Bridge will use to send funds to the customer.

Available options:
dai,
eur,
eurc,
mxn,
pyusd,
usd,
usdb,
usdc,
usdt
​
address
string
required

The crypto wallet address the customer will send funds to in order to initiate the payment processing

​
created_at
string<date-time>
required

Time of creation of the Liquidation Address

​
updated_at
string<date-time>
required

Time of last update of the Liquidation Address

​
prefunded_account_id
string

The developer's prefunded account to which Bridge will send the funds.

Required string length: 1 - 42
​
custom_developer_fee_percent
string<number> | null

The developer fee percent that will be applied to this Liquidation Address or null to use the default fee. The value is a base 100 percentage, i.e. 10.2% is 10.2 in the API.

Example:

"0.1"

​
global_developer_fee_percent
object

The developer fee percent that will be default applied to all Liquidation Addresses.

​
destination_wire_message
string

A message to be sent with a wire transfer.

Required string length: 1 - 256
​
destination_sepa_reference
string

A reference message to be sent with a SEPA transaction. We recommend you set a unique value to help you and your customers track payments end to end. It must be from 6 to 140 characters. The allowed characters are a-z, A-Z, 0-9, spaces, ampersand (&), hyphen (-), full stop (.), and solidus (/). If not populated, the default value is "Payment via Bridge {unique_token}".

Required string length: 6 - 140
​
destination_spei_reference
string

A payment reference message or remittance information to be included in a SPEI transaction. The allowed characters are alphanumeric a-z, A-Z, 0-9, and space

Required string length: 1 - 40
​
destination_ach_reference
string

A reference message to be sent with an ACH transaction. It can be at most 10 characters, A-Z, a-z, 0-9, and spaces.

Required string length: 1 - 10
​
destination_address
string

The crypto wallet address that Bridge will use to send funds to the customer.

​
destination_blockchain_memo
string

The memo to include in the transaction, for blockchains that support memos only

​
return_address
string

The crypto wallet address that Bridge will use to return funds to the customer in case of a failed transaction. This address must be on the same chain specified for the liquidation address. Please note, this functionality is not supported on Stellar.

​
state
string

The state of the liquidation address. It could be "active" or "deactivated"