3rd Party Beneficiary Delivery Price Channel

Request price streams for trades that deliver digital assets directly to third-party beneficiary wallets instead of your Zodia Markets account.

The price channel works identically to standard price streams, but requires two additional fields to specify the destination.

Prerequisites

Before requesting third-party settlement prices:

Beneficiary Setup

Beneficiaries must be configured:

• Complete beneficiary onboarding and verification either via Customer Portal or your Relationship Manager.

Each destination wallet address must be:

• Added to the beneficiary's wallet list
• Verified through Zodia Markets compliance process
• Enabled and active for trading

3. Network Configuration

Ensure the settlement network type is available for your account:

• ZM_TRANSFER is the default for crypto settlement
• Contact your Relationship Manager for additional network options

⚠️

Important

Orders will be rejected if:

• Beneficiary ID is not found or not approved
• The Beneficiary does not have a valid Wallet Address for the chosen asset or it is not whitelisted or enabled
• The payout currency is not specified

How It Differs from Standard Price Subscriptions

Third Party Settlement Price Subscription

{
    "messageType": "subscribe",
    "instrument": "USDC.USD",
    "quantity": "500000",
    "currency": "USD",
    "accountGrpUuid": "a6898bdd-856b-4259-b6e2-6ef66f2282e1",
    "tenor": "T",
    "beneficiaryDetails": {
        "beneficiaryId": "5fff78ca-d87f-424f-90bf-96b1906a284b",
        "payoutCurrency": "USDC"
    },
    "tag": "echo"
}

Key differences:

• ✅ Add beneficiaryDetails block
  • ✅ Add beneficiaryId field
  • ✅ Add payoutCurrency field
• ✅ Everything else remains identical

Additional Request Fields

Add these fields to your standard price subscription request:

All other fields remain the same as standard price subscriptions →.

Responses

Subscription success response messages remain identical to standard price streams except for the addition of the networkId, which will provide the network the payout will be executed on. For crypto payouts, this will be ZM_TRANSFER.

Price updates do not include beneficiary or network information. Use the quoteId to execute orders which will reference your subscription's beneficiary configuration.

{
  "chanId": "",
  "timestamp": 1773243625433,
  "messageType": "subscribe",
  "success": true,
  "message": "Subscribed",
  "subscriptionId": "838164a8-e795-4cfc-852b-c8dc3da8ca58",
  "tag": "e4795b61-55e2-4474-a1eb-53b85227b778",
  "instrument": "USDC.USD",
  "quantity": "500000.00000000",
  "code": "",
  "tenor": "T",
  "settleDate": "",
  "networkId": "ZM_TRANSFER"
}

Executing Orders with Third Party Settlement

When you execute an order on a third-party settlement price stream, the asset will be delivered to the specified beneficiary's wallet. The message format remains the same as a normal trade request with the exception of providing an additional field paymentReason.

{
  "accountGrpUuid": "2073252c-81ed-41be-bf4d-d51b8f2246b8",
  "clientRequestId": "5abc86ae-53cd-4f31-bbf4-8e598c7f6805",
  "messageType": "order",
  "quoteId": "Nu5EdH+siTnz9ch...",
  "side": "BUY",
  "paymentReason": "VASA"
}

Payment Reason Codes

The paymentReason field must be set to one of the following ISO codes:

Crypto & Assets

Property

Commercial

Personal

Financial

Employment

📘

Automatic Beneficiary Association

The quoteId is tied to your subscription, which includes the beneficiaryId and payoutCurrency. You don't need to specify beneficiary details in the order request.

Error Handling

Beneficiary Not Found

Causes:

• Invalid beneficiary UUID
• Beneficiary not configured for your account
• Beneficiary not yet approved

Beneficiary Wallet Not Found

Causes:

• No wallet address configured for this beneficiary
• Wallet not whitelisted for the requested asset
• No wallet address configured for this asset
• Wallet disabled or pending approval

Invalid Network ID

Cause: Network ID not available for your account

Solution: Contact your Relationship Manager to enable additional network types

Comparison: Standard vs Third Party Settlement