use std::fmt;
use serde::Deserialize;
use serde_json::Value;
use crate::core::models::common::{
AttemptStatus, Currency, IntentStatus, PaymentMethod, PaymentMethodType,
};
#[derive(Clone, Deserialize)]
#[non_exhaustive]
pub struct PaymentResponse {
pub payment_id: String,
pub merchant_id: String,
pub status: IntentStatus,
pub amount: i64,
pub currency: Currency,
#[serde(default)]
pub net_amount: Option<i64>,
#[serde(default)]
pub amount_capturable: Option<i64>,
#[serde(default)]
pub amount_received: Option<i64>,
#[serde(default)]
pub client_secret: Option<String>,
#[serde(default)]
pub connector: Option<String>,
#[serde(default)]
pub customer_id: Option<String>,
#[serde(default)]
pub profile_id: Option<String>,
#[serde(default)]
pub payment_method: Option<PaymentMethod>,
#[serde(default)]
pub error_code: Option<String>,
#[serde(default)]
pub error_message: Option<String>,
#[serde(default)]
pub next_action: Option<Value>,
#[serde(default)]
pub created: Option<String>,
#[serde(default)]
pub metadata: Option<Value>,
#[serde(default)]
pub test_mode: Option<bool>,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
impl fmt::Debug for PaymentResponse {
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
f.debug_struct("PaymentResponse")
.field("payment_id", &self.payment_id)
.field("merchant_id", &self.merchant_id)
.field("status", &self.status)
.field("amount", &self.amount)
.field("currency", &self.currency)
.field("net_amount", &self.net_amount)
.field("amount_capturable", &self.amount_capturable)
.field("amount_received", &self.amount_received)
.field(
"client_secret",
&self.client_secret.as_ref().map(|_| "[redacted]"),
)
.field("connector", &self.connector)
.field("customer_id", &self.customer_id)
.field("profile_id", &self.profile_id)
.field("payment_method", &self.payment_method)
.field("error_code", &self.error_code)
.field("error_message", &self.error_message)
.field("next_action", &self.next_action)
.field("created", &self.created)
.field("metadata", &self.metadata)
.field("extra", &self.extra)
.finish()
}
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct PaymentAttemptResponse {
pub attempt_id: String,
pub status: AttemptStatus,
#[serde(default)]
pub amount: Option<i64>,
#[serde(default)]
pub currency: Option<Currency>,
#[serde(default)]
pub connector: Option<String>,
#[serde(default)]
pub connector_transaction_id: Option<String>,
#[serde(default)]
pub payment_method: Option<PaymentMethod>,
#[serde(default)]
pub payment_method_type: Option<PaymentMethodType>,
#[serde(default)]
pub error_code: Option<String>,
#[serde(default)]
pub error_message: Option<String>,
#[serde(default)]
pub unified_code: Option<String>,
#[serde(default)]
pub unified_message: Option<String>,
#[serde(default)]
pub created_at: Option<String>,
#[serde(default)]
pub modified_at: Option<String>,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct PaymentStatusHistoryEvent {
pub entity_type: String,
pub timestamp: String,
#[serde(default)]
pub entity_id: Option<String>,
#[serde(default)]
pub attempt_id: Option<String>,
#[serde(default)]
pub previous_status: Option<String>,
#[serde(default)]
pub status: Option<String>,
#[serde(default)]
pub connector: Option<String>,
#[serde(default)]
pub error_code: Option<String>,
#[serde(default)]
pub error_message: Option<String>,
#[serde(default)]
pub is_creation: bool,
#[serde(default)]
pub derived: bool,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct PaymentStatusHistoryResponse {
pub payment_id: String,
#[serde(default)]
pub complete: bool,
#[serde(default)]
pub count: i64,
#[serde(default = "Vec::new")]
pub events: Vec<PaymentStatusHistoryEvent>,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
#[cfg(test)]
mod tests {
use super::*;
const WITH_SECRET: &str = r#"{
"payment_id": "pay_1", "merchant_id": "mer_1", "status": "requires_confirmation",
"amount": 1999, "currency": "EUR", "client_secret": "pay_1_secret_abc123"
}"#;
#[test]
fn payment_response_debug_redacts_the_client_secret() {
let res: PaymentResponse = serde_json::from_str(WITH_SECRET).unwrap();
let printed = format!("{res:?}");
assert!(!printed.contains("pay_1_secret_abc123"));
assert!(printed.contains("client_secret: Some(\"[redacted]\")"));
assert!(printed.contains("pay_1"));
assert!(printed.contains("1999"));
}
#[test]
fn payment_response_debug_shows_none_when_no_client_secret() {
let res: PaymentResponse = serde_json::from_str(
r#"{"payment_id":"pay_1","merchant_id":"mer_1","status":"succeeded",
"amount":1999,"currency":"EUR"}"#,
)
.unwrap();
assert!(format!("{res:?}").contains("client_secret: None"));
}
#[test]
fn status_history_parses_derived_and_non_status_events() {
let history: PaymentStatusHistoryResponse = serde_json::from_str(
r#"{
"payment_id": "pay_1",
"complete": false,
"count": 3,
"events": [
{
"entity_type": "payment",
"timestamp": "2026-08-01T10:00:00Z",
"status": "requires_confirmation",
"is_creation": true,
"derived": true
},
{
"entity_type": "attempt",
"entity_id": "pay_1_1",
"attempt_id": "pay_1_1",
"previous_status": "pending",
"status": "charged",
"connector": "stripe",
"timestamp": "2026-08-01T10:00:05Z",
"is_creation": false,
"derived": false
},
{
"entity_type": "checkout",
"entity_id": "apple_pay",
"status": "native_pane_selected",
"timestamp": "2026-08-01T10:00:03Z",
"is_creation": false,
"derived": false
}
]
}"#,
)
.unwrap();
assert_eq!(history.payment_id, "pay_1");
assert!(!history.complete);
assert_eq!(history.count, 3);
assert!(history.events[0].derived);
assert!(history.events[0].is_creation);
assert_eq!(history.events[0].previous_status, None);
assert_eq!(history.events[1].connector.as_deref(), Some("stripe"));
assert_eq!(history.events[2].entity_type, "checkout");
assert_eq!(
history.events[2].status.as_deref(),
Some("native_pane_selected")
);
}
#[test]
fn status_history_defaults_to_no_events() {
let history: PaymentStatusHistoryResponse =
serde_json::from_str(r#"{"payment_id":"pay_1"}"#).unwrap();
assert!(history.events.is_empty());
assert!(!history.complete);
}
}