Struct PaymentPayload 

#[non_exhaustive]
pub struct PaymentPayload<TAccepted, TPayload> {
    pub accepted: TAccepted,
    pub payload: TPayload,
    pub resource: Option<ResourceInfo>,
    pub x402_version: Version<2>,
    pub extensions: Extensions,
}

A signed payment authorization sent by the buyer to the seller.

In x402 v2 the payload is self-describing: it carries the accepted requirements the buyer chose (so the facilitator can re-verify them) plus the scheme-specific payload, an optional resource descriptor, and an optional extensions map.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

accepted: TAccepted

The terms the buyer accepted (a full super::PaymentRequirements form).

payload: TPayload

Scheme-specific signed payload (e.g., EIP-3009 authorization).

resource: Option<ResourceInfo>

Optional resource metadata copied from the 402 response.

x402_version: Version<2>

Protocol version marker (always 2).

extensions: Extensions

Optional extension payload block.

Implementations

impl<TAccepted, TPayload> PaymentPayload<TAccepted, TPayload>

pub fn new( accepted: TAccepted, payload: TPayload, ) -> PaymentPayload<TAccepted, TPayload>

Constructs a payload from the two required fields. Use the Self::with_resource / Self::with_extensions builders to attach the optional blocks.

pub fn with_resource( self, resource: ResourceInfo, ) -> PaymentPayload<TAccepted, TPayload>

Builder: attaches optional resource metadata.

pub fn with_optional_resource( self, resource: Option<ResourceInfo>, ) -> PaymentPayload<TAccepted, TPayload>

Builder: attaches an optional resource (passes through None untouched, useful when the value is produced via Option::map).

pub fn with_extensions( self, extensions: Extensions, ) -> PaymentPayload<TAccepted, TPayload>

Builder: replaces the extensions block.

Trait Implementations

impl<TAccepted, TPayload> Clone for PaymentPayload<TAccepted, TPayload>

where TAccepted: Clone, TPayload: Clone,

fn clone(&self) -> PaymentPayload<TAccepted, TPayload>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<TAccepted, TPayload> Debug for PaymentPayload<TAccepted, TPayload>

where TAccepted: Debug, TPayload: Debug,

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

Formats the value using the given formatter.

impl<'de, TAccepted, TPayload> Deserialize<'de> for PaymentPayload<TAccepted, TPayload>

where TAccepted: Deserialize<'de>, TPayload: Deserialize<'de>,

fn deserialize<__D>( __deserializer: __D, ) -> Result<PaymentPayload<TAccepted, TPayload>, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<TAccepted, TPayload> Serialize for PaymentPayload<TAccepted, TPayload>

where TAccepted: Serialize, TPayload: Serialize,

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

where __S: Serializer,

Serialize this value into the given Serde serializer.