Struct PaymentErrorDetails 

pub struct PaymentErrorDetails {
    pub problem_type: String,
    pub title: String,
    pub status: u16,
    pub detail: String,
    pub challenge_id: Option<String>,
}

RFC 9457 Problem Details structure for payment errors.

This struct provides a standardized format for HTTP error responses, following RFC 9457.

Example

use mpp::error::PaymentErrorDetails;

let problem = PaymentErrorDetails::core("verification-failed")
    .with_title("VerificationFailedError")
    .with_status(402)
    .with_detail("Payment verification failed: insufficient amount.");

// Serialize to JSON for HTTP response body
let json = serde_json::to_string(&problem).unwrap();

Fields

problem_type: String

A URI reference that identifies the problem type.

title: String

A short, human-readable summary of the problem type.

status: u16

The HTTP status code for this problem.

detail: String

A human-readable explanation specific to this occurrence.

challenge_id: Option<String>

The challenge ID associated with this error, if applicable.

Implementations

impl PaymentErrorDetails

pub fn new(type_uri: impl Into<String>) -> Self

Create a new PaymentErrorDetails with a full problem type URI.

pub fn core(suffix: impl Display) -> Self

Create a PaymentErrorDetails for a core payment-auth problem.

The full type URI will be {CORE_PROBLEM_TYPE_BASE}/{suffix}.

pub fn session(suffix: impl Display) -> Self

Create a PaymentErrorDetails for a session/channel problem.

The full type URI will be {SESSION_PROBLEM_TYPE_BASE}/{suffix}.

pub fn stream(suffix: impl Display) -> Self

👎Deprecated since 0.5.0:

renamed to session()

Deprecated: use PaymentErrorDetails::session instead. Remove in next major version.

pub fn with_title(self, title: impl Into<String>) -> Self

Set the title.

pub fn with_status(self, status: u16) -> Self

Set the HTTP status code.

pub fn with_detail(self, detail: impl Into<String>) -> Self

Set the detail message.

pub fn with_challenge_id(self, id: impl Into<String>) -> Self

Set the associated challenge ID.

Trait Implementations

impl Clone for PaymentErrorDetails

fn clone(&self) -> PaymentErrorDetails

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PaymentErrorDetails

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PaymentErrorDetails

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for PaymentErrorDetails

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

where __S: Serializer,

Serialize this value into the given Serde serializer.