use serde::Deserialize;
use serde_json::Value;
use crate::core::models::common::{Currency, PaymentMethod, PaymentMethodType};
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct PaymentMethodResponse {
pub merchant_id: String,
pub payment_method_id: String,
pub payment_method: PaymentMethod,
#[serde(default)]
pub customer_id: Option<String>,
#[serde(default)]
pub payment_method_type: Option<PaymentMethodType>,
#[serde(default)]
pub recurring_enabled: Option<bool>,
#[serde(default)]
pub payment_token: Option<String>,
#[serde(default)]
pub status: Option<String>,
#[serde(default)]
pub created: Option<String>,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct CustomerPaymentMethodsListResponse {
#[serde(default = "Vec::new")]
pub customer_payment_methods: Vec<PaymentMethodResponse>,
#[serde(default)]
pub is_guest_customer: Option<bool>,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct PaymentMethodDisplayInfo {
#[serde(default)]
pub display_name: Option<String>,
#[serde(default)]
pub icon_slug: Option<String>,
#[serde(default)]
pub icon_url: Option<String>,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct AmountRange {
pub min_amount: i64,
pub max_amount: i64,
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct PaymentMethodAmountLimits {
#[serde(default)]
pub currency: Option<Currency>,
#[serde(default)]
pub min_amount: Option<i64>,
#[serde(default)]
pub max_amount: Option<i64>,
#[serde(default = "Vec::new")]
pub excluded_ranges: Vec<AmountRange>,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct ResponsePaymentMethodTypes {
pub payment_method_type: PaymentMethodType,
#[serde(default)]
pub payment_experience: Option<Vec<Value>>,
#[serde(default)]
pub card_networks: Option<Vec<Value>>,
#[serde(default)]
pub bank_names: Option<Vec<Value>>,
#[serde(default)]
pub bank_debits: Option<Value>,
#[serde(default)]
pub bank_transfers: Option<Value>,
#[serde(default)]
pub required_fields: Option<Value>,
#[serde(default)]
pub surcharge_details: Option<Value>,
#[serde(default)]
pub pm_auth_connector: Option<String>,
#[serde(default)]
pub display: Option<PaymentMethodDisplayInfo>,
#[serde(default)]
pub amount_limits: Option<PaymentMethodAmountLimits>,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct ResponsePaymentMethodsEnabled {
pub payment_method: PaymentMethod,
#[serde(default = "Vec::new")]
pub payment_method_types: Vec<ResponsePaymentMethodTypes>,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct PaymentMethodListResponse {
#[serde(default = "Vec::new")]
pub payment_methods: Vec<ResponsePaymentMethodsEnabled>,
#[serde(default)]
pub currency: Option<Currency>,
#[serde(default)]
pub redirect_url: Option<String>,
#[serde(default)]
pub mandate_payment: Option<Value>,
#[serde(default)]
pub merchant_name: Option<String>,
#[serde(default)]
pub show_surcharge_breakup_screen: Option<bool>,
#[serde(default)]
pub payment_type: Option<String>,
#[serde(default)]
pub request_external_three_ds_authentication: Option<bool>,
#[serde(default)]
pub collect_shipping_details_from_wallets: Option<bool>,
#[serde(default)]
pub collect_billing_details_from_wallets: Option<bool>,
#[serde(default)]
pub is_tax_calculation_enabled: Option<bool>,
#[serde(default)]
pub sdk_next_action: Option<Value>,
#[serde(default)]
pub is_guest_customer: Option<bool>,
#[serde(default)]
pub intent_data: Option<Value>,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn discovery_response_parses_the_envelope_with_display_and_limits() {
let listed: PaymentMethodListResponse = serde_json::from_str(
r#"{
"currency": "EUR",
"merchant_name": "Shop",
"payment_methods": [
{
"payment_method": "card",
"payment_method_types": [
{
"payment_method_type": "credit",
"display": {"display_name": "Credit Card", "icon_slug": "card"},
"amount_limits": {
"currency": "EUR",
"min_amount": 100,
"max_amount": 500000,
"excluded_ranges": [{"min_amount": 1000, "max_amount": 1999}]
}
}
]
}
]
}"#,
)
.unwrap();
let group = &listed.payment_methods[0];
let method = &group.payment_method_types[0];
assert_eq!(
method.display.as_ref().unwrap().icon_slug.as_deref(),
Some("card")
);
let limits = method.amount_limits.as_ref().unwrap();
assert_eq!(limits.min_amount, Some(100));
assert_eq!(limits.excluded_ranges[0].min_amount, 1000);
assert_eq!(limits.excluded_ranges[0].max_amount, 1999);
}
#[test]
fn discovery_response_tolerates_missing_render_hints() {
let listed: PaymentMethodListResponse = serde_json::from_str(
r#"{"payment_methods":[{"payment_method":"wallet","payment_method_types":[]}]}"#,
)
.unwrap();
assert_eq!(listed.payment_methods.len(), 1);
assert_eq!(listed.currency, None);
assert_eq!(listed.sdk_next_action, None);
}
#[test]
fn customer_saved_methods_parse_as_an_envelope() {
let listed: CustomerPaymentMethodsListResponse = serde_json::from_str(
r#"{
"customer_payment_methods": [
{"merchant_id":"mer_1","payment_method_id":"pm_1","payment_method":"card"}
],
"is_guest_customer": false
}"#,
)
.unwrap();
assert_eq!(listed.customer_payment_methods[0].payment_method_id, "pm_1");
assert_eq!(listed.is_guest_customer, Some(false));
}
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct PaymentMethodPresentationResponse {
pub contract_version: u32,
pub revision: String,
pub scope: String,
pub environment: String,
pub locale: String,
pub context: PresentationContext,
pub status: String,
pub layout_source: String,
pub cache: PresentationCachePolicy,
#[serde(default)]
pub entries: Vec<PaymentMethodPresentationEntry>,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct PresentationContext {
#[serde(default)]
pub country: Option<String>,
#[serde(default)]
pub currency: Option<Currency>,
#[serde(default)]
pub amount: Option<i64>,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct PresentationCachePolicy {
pub max_age_seconds: u32,
pub stale_if_error_seconds: u32,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct PaymentMethodPresentationEntry {
pub id: String,
pub kind: String,
pub tier: String,
#[serde(default)]
pub row: Option<u32>,
pub label: String,
#[serde(default)]
pub sublabel: Option<String>,
pub label_source: String,
pub sublabel_source: String,
#[serde(default)]
pub category: Option<String>,
#[serde(default)]
pub icon: Option<PresentationIcon>,
#[serde(default)]
pub fallback_icon: Option<String>,
#[serde(default)]
pub payment_method: Option<PaymentMethod>,
#[serde(default)]
pub payment_method_type: Option<PaymentMethodType>,
#[serde(default)]
pub provider_name: Option<String>,
pub requires_device_support: bool,
pub further_choice: String,
pub children_detail: String,
#[serde(default)]
pub children: Vec<PresentationChild>,
pub children_status: String,
#[serde(default)]
pub children_source: Option<String>,
#[serde(default)]
pub children_checked_at: Option<String>,
pub children_stale: bool,
pub children_narrowed: bool,
#[serde(default)]
pub action: Option<PresentationAction>,
#[serde(default)]
pub members: Option<Vec<PaymentMethodPresentationEntry>>,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct PresentationIcon {
#[serde(rename = "type")]
pub kind: String,
#[serde(default)]
pub key: Option<String>,
#[serde(default)]
pub data_uri: Option<String>,
#[serde(default)]
pub sha256: Option<String>,
#[serde(default)]
pub source: Option<String>,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct PresentationChild {
pub id: String,
pub kind: String,
pub label: String,
#[serde(default)]
pub icon: Option<PresentationIcon>,
pub source: String,
pub selection: String,
#[serde(default)]
pub direct_entry_id: Option<String>,
#[serde(default)]
pub payment_method_type: Option<PaymentMethodType>,
#[serde(default)]
pub code: Option<String>,
#[serde(default)]
pub network: Option<PresentationCryptoNetwork>,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct PresentationCryptoNetwork {
pub id: String,
pub label: String,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}
#[derive(Debug, Clone, Deserialize)]
#[non_exhaustive]
pub struct PresentationAction {
#[serde(rename = "type")]
pub kind: String,
#[serde(flatten)]
pub extra: serde_json::Map<String, Value>,
}