Struct WalletAuthorizationRequest 

pub struct WalletAuthorizationRequest {
    pub customer_display: Option<OperationCustomerDisplay>,
    pub external_reference_id: Option<ExternalReferenceId>,
    pub metadata: Option<Metadata>,
    pub option_id: String,
    pub signed_payloads: Vec<OnchainSignedPayload>,
}

A request to authorize a payment session using a wallet. The payer selects one of the options returned by the wallet authorization options endpoint and submits the signed payloads.

JSON schema

{
 "description": "A request to authorize a payment session using a wallet. The payer selects one of the options returned by the wallet authorization options endpoint and submits the signed payloads.",
 "examples": [
   {
     "optionId": "opt_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
     "signedPayloads": [
       {
         "payloadId": "payload_af2937b0-9846-4fe7-bfe9-ccc22d935114",
         "signature": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab"
       }
     ]
   }
 ],
 "type": "object",
 "required": [
   "optionId",
   "signedPayloads"
 ],
 "properties": {
   "customerDisplay": {
     "description": "Optional customer-facing display data for this authorization, shown to the payer. Falls back to the session's `orderCode` when `referenceCode` is omitted.",
     "examples": [
       {
         "referenceCode": "REF-ABC123"
       }
     ],
     "allOf": [
       {
         "$ref": "#/components/schemas/OperationCustomerDisplay"
       }
     ]
   },
   "externalReferenceId": {
     "description": "An optional merchant-provided internal identifier for this wallet authorization, from the merchant's own system—not visible to the payer.",
     "examples": [
       "merchant-authorization-abc123"
     ],
     "allOf": [
       {
         "$ref": "#/components/schemas/ExternalReferenceId"
       }
     ]
   },
   "metadata": {
     "$ref": "#/components/schemas/Metadata"
   },
   "optionId": {
     "description": "The identifier of the chosen authorization option. Must match an `optionId` from the wallet authorization options response.",
     "examples": [
       "opt_a1b2c3d4-e5f6-7890-abcd-ef1234567890"
     ],
     "type": "string"
   },
   "signedPayloads": {
     "description": "The processed payloads from the payer, corresponding to the payloads in the selected authorization option.",
     "examples": [
       [
         {
           "payloadId": "payload_af2937b0-9846-4fe7-bfe9-ccc22d935114",
           "signature": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab"
         }
       ]
     ],
     "type": "array",
     "items": {
       "$ref": "#/components/schemas/OnchainSignedPayload"
     }
   }
 }
}

Fields

customer_display: Option<OperationCustomerDisplay>

Optional customer-facing display data for this authorization, shown to the payer. Falls back to the session’s orderCode when referenceCode is omitted.

external_reference_id: Option<ExternalReferenceId>

An optional merchant-provided internal identifier for this wallet authorization, from the merchant’s own system—not visible to the payer.

metadata: Option<Metadata>

option_id: String

The identifier of the chosen authorization option. Must match an optionId from the wallet authorization options response.

signed_payloads: Vec<OnchainSignedPayload>

The processed payloads from the payer, corresponding to the payloads in the selected authorization option.

Implementations

impl WalletAuthorizationRequest

pub fn builder() -> WalletAuthorizationRequest

Trait Implementations

impl Clone for WalletAuthorizationRequest

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 WalletAuthorizationRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for WalletAuthorizationRequest

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&WalletAuthorizationRequest> for WalletAuthorizationRequest

fn from(value: &WalletAuthorizationRequest) -> Self

Converts to this type from the input type.

impl From<WalletAuthorizationRequest> for WalletAuthorizationRequest

fn from(value: WalletAuthorizationRequest) -> Self

Converts to this type from the input type.

impl Serialize for WalletAuthorizationRequest

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<WalletAuthorizationRequest> for WalletAuthorizationRequest

type Error = ConversionError

The type returned in the event of a conversion error.

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

Performs the conversion.