Struct PaymentPayload 

#[non_exhaustive]
pub struct PaymentPayload<TAccepted, TPayload> {
    pub accepted: TAccepted,
    pub payload: TPayload,
    pub resource: Option<ResourceInfo>,
    pub x402_version: Version2,
    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: Version2

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) -> Self

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) -> Self

Builder: attaches optional resource metadata.

pub fn with_optional_resource(self, resource: Option<ResourceInfo>) -> Self

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) -> Self

Builder: replaces the extensions block.

Trait Implementations

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

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: Debug, TPayload: Debug> Debug for PaymentPayload<TAccepted, TPayload>

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

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<Self, __D::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::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.