Create a new liquidation address for a customer

POST https://penny-api-restricted-dev.alfredpay.io/api/v1/third-party-service/penny/liquidation-addresses/{customerId}

Register a new crypto liquidation address for a given customer.

Behavior and validations:

• Validates required fields: chain, currency and address.
• chain must be one of the supported chain identifiers (see API enum).
• currency must be a supported token symbol for the selected chain.
• address is stored after format validation for the selected chain and length checks are applied.
• Optional memo is allowed for chains that require extra destination info (e.g., XLM).
• If default is true, the address will be marked as the customer's default and any previously default address for that customer will be unset.
• The endpoint returns 409 when an identical address (same chain, currency and address) already exists for the customer.

Supported chains:

• ETH, MATIC, XLM, OP, ARB, BASE, TRX, SOL, CELO, AVAX, BNB.
  • Note: XLM requires (or commonly uses) a memo field for destination tagging — provide memo when necessary.

Example usage: POST /third-party-service/penny/liquidation-addresses/:customerId Body: { "chain": "ARB", "currency": "USDC", "address": "0x...", "default": true }

Notes:

• Request must include service headers api-key and api-secret.
• The API performs server-side normalization and will return the created resource on success (201).