adk-payments 0.6.0

Protocol-neutral agentic commerce and payment orchestration for ADK-Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

use serde::{Deserialize, Serialize};

/// ACP discovery document served from `/.well-known/acp.json`.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct AcpDiscoveryDocument {
    /// Protocol identification and supported version set.
    pub protocol: AcpDiscoveryProtocol,
    /// Base URL for ACP REST routes.
    pub api_base_url: String,
    /// Transport bindings offered by the merchant deployment.
    pub transports: Vec<AcpDiscoveryTransport>,
    /// Stable seller capabilities that do not vary by session.
    pub capabilities: AcpDiscoveryCapabilities,
}

/// ACP discovery protocol metadata.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct AcpDiscoveryProtocol {
    /// Protocol identifier. Always `"acp"`.
    pub name: String,
    /// Latest ACP version served by the merchant.
    pub version: String,
    /// All supported ACP versions in chronological order.
    pub supported_versions: Vec<String>,
    /// Optional operator documentation URL.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub documentation_url: Option<String>,
}

/// ACP discovery transport binding.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "lowercase")]
pub enum AcpDiscoveryTransport {
    /// REST endpoints rooted at `apiBaseUrl`.
    Rest,
    /// An MCP transport surface backed by the same merchant deployment.
    Mcp,
}

/// Stable ACP service advertised in discovery.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum AcpDiscoveryService {
    /// Checkout-session negotiation and completion.
    Checkout,
    /// Order-status retrieval and synchronization.
    Orders,
    /// Delegated payment-token creation.
    DelegatePayment,
}

/// Stable intervention family advertised in discovery.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
pub enum AcpDiscoveryInterventionType {
    /// Browser-based 3DS intervention.
    #[serde(rename = "3ds")]
    ThreeDs,
    /// Biometric or device confirmation.
    #[serde(rename = "biometric")]
    Biometric,
    /// Address correction or verification.
    #[serde(rename = "address_verification")]
    AddressVerification,
}

/// High-level extension declaration surfaced in discovery.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct AcpDiscoveryExtension {
    /// Extension identifier.
    pub name: String,
    /// Optional extension specification URL.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub spec: Option<String>,
    /// Optional JSON Schema URL for the extension.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub schema: Option<String>,
}

/// Stable merchant capability set exposed in discovery.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct AcpDiscoveryCapabilities {
    /// Services implemented by the merchant deployment.
    pub services: Vec<AcpDiscoveryService>,
    /// Optional extension declarations.
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub extensions: Vec<AcpDiscoveryExtension>,
    /// Optional intervention families supported by the merchant.
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub intervention_types: Vec<AcpDiscoveryInterventionType>,
    /// Optional lowercase ISO-4217 currency codes.
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub supported_currencies: Vec<String>,
    /// Optional supported locale tags.
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub supported_locales: Vec<String>,
}