--- title: "Update a Liquidation Address" method: PUT path: "/customers/{customerID}/liquidation_addresses/{liquidationAddressID}" tags: ["Liquidation Addresses"] --- # Update a Liquidation Address `PUT /customers/{customerID}/liquidation_addresses/{liquidationAddressID}` Update a Liquidation Address for the specified liquidation address ID. Note that `external_account_id` and `custom_developer_fee_percent` can be updated independently and are not both required. ## Path parameters - `customerID` string, required — A UUID that uniquely identifies a resource - `liquidationAddressID` string, required — A UUID that uniquely identifies a resource ## Request body - UpdateLiquidationAddress - `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, nullable — 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. - `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. - `destination_wire_message` string — A message to be sent with a wire transfer. It can have up to 140 characters. This message will be validated against 4 lines, each with a max length of 35 characters according to the Fedwire standard. - `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}". - `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 - `destination_reference` string, nullable — A payment reference message for newer payment rails (e.g. Pix and Faster Payments). Send `null` to clear an existing reference. - `return_address` string, nullable — Deprecated: use `return_instructions` instead. The crypto wallet address that Bridge will use to return funds to the customer in case of a failed transaction. Must be on the same chain as the liquidation address. Cannot be used on Stellar — use `return_instructions` with a `memo` instead. - `return_instructions` ReturnInstructions — Optional instructions for where to send funds if the transfer is returned (e.g. refund). Only supported when the source payment rail is crypto. Memo is required when the source payment rail is Stellar. - `address` string, required — The crypto wallet address to send returned funds to. Must be valid for the source payment rail's chain. - `memo` string — Memo to include with the return transaction. Required when the source payment rail is Stellar; optional for other memo-capable chains. ## Response `200` Updated Liquidation Address object - LiquidationAddress - `id` string, required — A UUID that uniquely identifies a resource - `currency` 'usdb' | 'usdc' | 'usdt' | 'pyusd' | 'eurc', required - `chain` 'arbitrum' | 'avalanche_c_chain' | 'base' | 'celo' | 'ethereum' | 'optimism' | 'polygon' | 'solana' | 'stellar' | 'tempo' | 'tron' | 'evm', required - `customer_id` string, required — A UUID that uniquely identifies a resource - `external_account_id` string, required — A UUID that uniquely identifies a resource - `prefunded_account_id` string — A UUID that uniquely identifies a resource - `custom_developer_fee_percent` string, number, nullable — 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. - `global_developer_fee_percent` LiquidationAddressGlobalDeveloperFeePercent — The developer fee percent that will be default applied to all Liquidation Addresses. - `percent` string, number, nullable - `destination_wire_message` string — A message to be sent with a wire transfer. It can have up to 140 characters. This message will be validated against 4 lines, each with a max length of 35 characters according to the Fedwire standard. - `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}". - `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 - `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. - `destination_payment_rail` 'ach' | 'wire' | 'ach_push' | 'ach_same_day' | 'arbitrum' | 'avalanche_c_chain' | 'base' | 'bre_b' | 'co_bank_transfer' | 'celo' | 'ethereum' | 'faster_payments' | 'fiat_deposit_return' | 'optimism' | 'pix' | 'polygon' | 'sepa' | 'solana' | 'spei' | 'stellar' | 'swift' | 'tempo' | 'tron', required - `destination_currency` 'brl' | 'cop' | 'eur' | 'eurc' | 'gbp' | 'mxn' | 'pyusd' | 'usd' | 'usdb' | 'usdc' | 'usdt', required - `address` string, required — The crypto wallet address the customer will send funds to in order to initiate the payment processing - `memoless_address` string — An alternative crypto wallet address that encodes the memo, allowing the customer to send funds without needing to include a separate memo. Currently only available for Stellar deposits. - `blockchain_memo` string — The memo that must be included with the deposit transaction when sending funds to the deposit address. Only present for blockchains that require memos (such as Stellar). - `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, nullable — Deprecated: use `return_instructions` instead. The crypto wallet address that Bridge will use to return funds to the customer in case of a failed transaction. Must be on the same chain as the liquidation address. Cannot be used on Stellar — use `return_instructions` with a `memo` instead. - `return_memo` string, nullable — The memo included with return transactions. Present when `return_instructions` was set with a memo (e.g. required for Stellar to route funds to the correct end-customer). - `state` string — The state of the liquidation address. It could be "active" or "deactivated" - `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 ## Other responses - `400` — Request containing missing or invalid parameters. - `401` — Missing or invalid API key - `500` — Unexpected error. User may try and send the request again. --- [API](https://skmtc.net/bridge/apis/bridge-api.md) · [All operations](https://skmtc.net/bridge/apis/bridge-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bridge/bridge-api/revisions/570998bde3b5/schema)