africastalking 0.1.0

Unofficial Rust SDK for Africa's Talking 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

// src/modules/airtime.rs
//! Airtime module implementation

use crate::{client::AfricasTalkingClient, error::Result, Currency};
use serde::{Deserialize, Serialize};

/// Airtime module for sending airtime
#[derive(Debug, Clone)]
pub struct AirtimeModule {
    client: AfricasTalkingClient,
}

impl AirtimeModule {
    pub(crate) fn new(client: AfricasTalkingClient) -> Self {
        Self { client }
    }
    
    /// Send airtime to recipients
    pub async fn send(&self, request: SendAirtimeRequest) -> Result<SendAirtimeResponse> {
        self.client.post("/version1/airtime/send", &request).await
    }
}

#[derive(Debug, Serialize)]
pub struct SendAirtimeRequest {
    pub recipients: Vec<AirtimeRecipient>,
}

#[derive(Debug, Serialize)]
pub struct AirtimeRecipient {
    #[serde(rename = "phoneNumber")]
    pub phone_number: String,
    #[serde(rename = "currencyCode")]
    pub currency_code: String,
    pub amount: String,
}

impl AirtimeRecipient {
    pub fn new<S: Into<String>>(phone_number: S, amount: S, currency: Currency) -> Self {
        Self {
            phone_number: phone_number.into(),
            currency_code: currency.as_str().to_string(),
            amount: amount.into(),
        }
    }
}

#[derive(Debug, Deserialize)]
pub struct SendAirtimeResponse {
    #[serde(rename = "errorMessage")]
    pub error_message: String,
    #[serde(rename = "numSent")]
    pub num_sent: u32,
    #[serde(rename = "totalAmount")]
    pub total_amount: String,
    #[serde(rename = "totalDiscount")]
    pub total_discount: String,
    #[serde(rename = "responses")]
    pub responses: Vec<AirtimeResponse>,
}

#[derive(Debug, Deserialize)]
pub struct AirtimeResponse {
    #[serde(rename = "phoneNumber")]
    pub phone_number: String,
    #[serde(rename = "amount")]
    pub amount: String,
    #[serde(rename = "status")]
    pub status: String,
    #[serde(rename = "requestId")]
    pub request_id: String,
    #[serde(rename = "discount")]
    pub discount: String,
    #[serde(rename = "errorMessage")]
    pub error_message: String,
}