delopay 0.7.0

Official Rust SDK for the DeloPay payments API
Documentation
//! The dispute model.

use serde::Deserialize;
use serde_json::Value;

use crate::core::models::common::{Currency, DisputeStage, DisputeStatus};

/// Whether a processor tells DeloPay how a dispute ended.
///
/// Four states rather than a bool: `"unknown"` — we have not checked — is not
/// `"not_reported"`, and `"loss_only"` (it reports a loss and never a win) is
/// neither. Rounding that to `"reported"` would promise an outcome that never
/// comes for a dispute the merchant wins.
pub type DisputeOutcomeReporting = String;

/// A dispute as returned by the API.
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct DisputeResponse {
    /// Unique dispute ID.
    pub dispute_id: String,
    /// ID of the disputed payment.
    pub payment_id: String,
    /// Disputed amount (as a string, in minor units).
    pub amount: String,
    /// Three-letter ISO 4217 currency code.
    pub currency: Currency,
    /// Dispute lifecycle stage.
    pub dispute_stage: DisputeStage,
    /// Dispute status.
    pub dispute_status: DisputeStatus,
    /// Connector that reported the dispute.
    #[serde(default)]
    pub connector: Option<String>,
    /// Connector's own dispute ID.
    #[serde(default)]
    pub connector_dispute_id: Option<String>,
    /// Reason reported by the connector.
    #[serde(default)]
    pub connector_reason: Option<String>,
    /// Deadline to submit a challenge, if any.
    #[serde(default)]
    pub challenge_required_by: Option<String>,
    /// Whether this processor tells DeloPay how a dispute ended — see
    /// [`DisputeOutcomeReporting`]. `None` on a router that predates the
    /// field, which reads as `"unknown"`.
    #[serde(default)]
    pub outcome_reporting: Option<DisputeOutcomeReporting>,
    /// Shop (business profile) ID.
    #[serde(default)]
    pub profile_id: Option<String>,
    /// ISO 8601 creation timestamp.
    #[serde(default)]
    pub created_at: Option<String>,
    /// Any additional response fields not modeled above.
    #[serde(flatten)]
    pub extra: serde_json::Map<String, Value>,
}