Struct IneligibleWalletAuthorizationAddress 

pub struct IneligibleWalletAuthorizationAddress {
    pub address: BlockchainAddress,
    pub code: IneligibleWalletAuthorizationAddressCode,
    pub funds_required: Vec<WalletAuthorizationFundsRequirement>,
    pub message: String,
}

A requested payer wallet address that has no eligible authorization option for this payment session, along with a machine- and human-readable reason.

JSON schema

{
 "title": "Ineligible Wallet Authorization Address",
 "description": "A requested payer wallet address that has no eligible authorization option for this payment session, along with a machine- and human-readable reason.",
 "examples": [
   {
     "address": "0xDeF9876543210FeDcBa9876543210FedcBa987654",
     "code": "insufficient_funds",
     "fundsRequired": [
       {
         "asset": "usdc",
         "currentBalance": "0.40",
         "network": "base",
         "requiredBalance": "1.00"
       },
       {
         "asset": "usdc",
         "currentBalance": "0.00",
         "network": "ethereum",
         "requiredBalance": "1.00"
       }
     ],
     "message": "The payer does not have sufficient funds."
   }
 ],
 "type": "object",
 "required": [
   "address",
   "code",
   "message"
 ],
 "properties": {
   "address": {
     "description": "The requested payer wallet address that has no eligible authorization option.",
     "examples": [
       "0xDeF9876543210FeDcBa9876543210FedcBa987654"
     ],
     "allOf": [
       {
         "$ref": "#/components/schemas/BlockchainAddress"
       }
     ]
   },
   "code": {
     "description": "A machine-readable code indicating why this address has no eligible authorization option. The enum is closed — any value the server returns must be listed below. Adding a new code is a deliberate, coordinated API change; clients receiving an undocumented value should treat it as a server violating the spec.",
     "examples": [
       "insufficient_funds"
     ],
     "type": "string",
     "enum": [
       "insufficient_funds",
       "superseded_by_preferred_option"
     ],
     "x-enum-descriptions": [
       "The address does not hold enough of the session asset on a supported source network to cover the session amount.",
       "The address was superseded because a preferred funding option was selected instead."
     ]
   },
   "fundsRequired": {
     "description": "The funding options for this address, one entry per (network, asset) combination the payer could fund to become eligible. Only present when `code` is `insufficient_funds`, and honors the request's `network` and `asset` filters. May be an empty array.",
     "examples": [
       [
         {
           "asset": "usdc",
           "currentBalance": "0.40",
           "network": "base",
           "requiredBalance": "1.00"
         },
         {
           "asset": "usdc",
           "currentBalance": "0.00",
           "network": "ethereum",
           "requiredBalance": "1.00"
         }
       ]
     ],
     "type": "array",
     "items": {
       "$ref": "#/components/schemas/WalletAuthorizationFundsRequirement"
     }
   },
   "message": {
     "description": "A human-readable, English-language description of why this address has no eligible authorization option. Suitable for surfacing in product UIs — does not contain personally identifiable information or internal infrastructure details. Clients that need localized strings should dispatch on `code` and provide their own translations.",
     "examples": [
       "The payer does not have sufficient funds."
     ],
     "type": "string"
   }
 }
}

Fields

address: BlockchainAddress

The requested payer wallet address that has no eligible authorization option.

code: IneligibleWalletAuthorizationAddressCode

A machine-readable code indicating why this address has no eligible authorization option. The enum is closed — any value the server returns must be listed below. Adding a new code is a deliberate, coordinated API change; clients receiving an undocumented value should treat it as a server violating the spec.

funds_required: Vec<WalletAuthorizationFundsRequirement>

The funding options for this address, one entry per (network, asset) combination the payer could fund to become eligible. Only present when code is insufficient_funds, and honors the request’s network and asset filters. May be an empty array.

message: String

A human-readable, English-language description of why this address has no eligible authorization option. Suitable for surfacing in product UIs — does not contain personally identifiable information or internal infrastructure details. Clients that need localized strings should dispatch on code and provide their own translations.

Implementations

impl IneligibleWalletAuthorizationAddress

pub fn builder() -> IneligibleWalletAuthorizationAddress

Trait Implementations

impl Clone for IneligibleWalletAuthorizationAddress

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for IneligibleWalletAuthorizationAddress

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for IneligibleWalletAuthorizationAddress

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&IneligibleWalletAuthorizationAddress> for IneligibleWalletAuthorizationAddress

fn from(value: &IneligibleWalletAuthorizationAddress) -> Self

Converts to this type from the input type.

impl From<IneligibleWalletAuthorizationAddress> for IneligibleWalletAuthorizationAddress

fn from(value: IneligibleWalletAuthorizationAddress) -> Self

Converts to this type from the input type.

impl Serialize for IneligibleWalletAuthorizationAddress

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<IneligibleWalletAuthorizationAddress> for IneligibleWalletAuthorizationAddress

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from( value: IneligibleWalletAuthorizationAddress, ) -> Result<Self, ConversionError>

Performs the conversion.