stripe-rust 0.1.1

A rust wrapper for the Stripe HTTP API
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
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116

use error::Error;
use http;
use params::{List, Metadata, Timestamp};
use resources::{Discount, Plan};

#[derive(Serialize)]
pub struct InvoiceParams {
    #[serde(skip_serializing_if = "Option::is_none")] pub application_fee: Option<u64>,
    #[serde(skip_serializing_if = "Option::is_none")] pub customer: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")] pub description: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")] pub statement_descriptor: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")] pub subscription: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")] pub tax_percent: Option<f64>,

    #[serde(skip_serializing_if = "Option::is_none")] pub closed: Option<bool>,
    #[serde(skip_serializing_if = "Option::is_none")] pub forgiven: Option<bool>,
}

/*
#[derive(Serialize)]
pub struct InvoiceListLinesParams {
    #[serde(skip_serializing_if = "Option::is_none")] pub limit: Option<u64>,
    #[serde(skip_serializing_if = "Option::is_none")] pub ending_before: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")] pub starting_after: Option<String>,

    ..
}
*/

#[derive(Deserialize)]
pub struct Period {
    pub start: Timestamp,
    pub end: Timestamp,
}

#[derive(Deserialize)]
pub struct InvoiceLine {
    pub id: String,
    pub amount: u64,
    pub current: String, // eg. "usd"
    pub description: Option<String>,
    pub discountable: bool,
    pub livemode: bool,
    pub metadata: Metadata,
    pub period: Period,
    pub plan: Option<Plan>,
    pub proration: bool,
    pub quantity: Option<u64>,
    pub subscription: Option<String>,
    pub subscription_item: Option<String>,
    #[serde(rename = "type")] pub item_type: String, // (invoiceitem, subscription)
}

#[derive(Deserialize)]
pub struct Invoice {
    pub id: String,
    pub amount_due: u64,
    pub application_fee: Option<u64>,
    pub attempt_count: u64,
    pub attempted: bool,
    pub charge: Option<String>,
    pub closed: bool,
    pub currency: String, // eg. "usd"
    pub customer: String,
    pub date: Timestamp,
    pub description: Option<String>,
    pub discount: Option<Discount>,
    pub ending_balance: Option<i64>,
    pub forgiven: bool,
    pub lines: List<InvoiceLine>,
    pub livemode: bool,
    pub metadata: Metadata,
    pub next_payment_attempt: Option<Timestamp>,
    pub paid: bool,
    pub period_end: Timestamp,
    pub period_start: Timestamp,
    pub receipt_number: Option<String>,
    pub starting_balance: i64,
    pub statment_descriptor: Option<String>,
    pub subscription: Option<String>,
    pub subscription_proration_date: Option<Timestamp>,
    pub subtotal: i64,
    pub tax: Option<i64>,
    pub tax_percent: Option<f64>,
    pub total: i64,
    pub webhooks_delivered_at: Option<Timestamp>,
}

impl Invoice {
    pub fn create(params: InvoiceParams, key: &str) -> Result<Invoice, Error> {
        return http::post("/invoices", key, params);
    }

    pub fn get(invoice_id: &str, key: &str) -> Result<Invoice, Error> {
        return http::get(&format!("/invoices/{}", invoice_id), key);
    }

    // TODO: Implement InvoiceListLinesParams
    // pub fn get_lines(invoice_id: &str, params: InvoiceListLinesParams, key: &str) -> Result<List<InvoiceLine>, Error> {
    //     return http::get(&format!("/invoices/{}/lines", invoice_id), key);
    // }

    // TODO: Implement InvoiceUpcomingParams
    // pub fn get_upcoming(params: InvoiceUpcomingParams, key: &str) -> Result<Invoice, Error> {
    //     return http::get(&format!("/invoices/upcoming?customer={}", invoice_id), key);
    // }

    pub fn pay(invoice_id: &str, key: &str) -> Result<Invoice, Error> {
        return http::post(&format!("/invoices/{}/pay", invoice_id), key, ());
    }

    // TODO: Implement InvoiceListParams
    // pub fn list(params: InvoiceListParams, key: &str) -> Result<List<InvoiceLine>, Error> {
    //     return http::get(&format!("/invoices/{}/lines", invoice_id), key);
    // }
}