payment_kit 0.1.1

A modular and extensible library designed to simplify payment processing, including payment creation, status checks, and refunds.
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

use serde::{Deserialize, Serialize};
use crate::status::PaymentStatus;

/// Represents the supported types of payment instruments.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub enum PaymentInstrument {
    CreditCard { provider: String },
    VirtualAccount { provider: String },
    BankTransfer { provider: String },
    EWallet { provider: String },
    Custom { provider: String },
}

/// Payload sent to initiate a payment transaction.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct PaymentRequest {
    pub order_id: String,
    pub amount: u64,
    pub currency: String,
    pub payment_instrument: PaymentInstrument,
    pub customer_id: Option<String>,
    pub description: Option<String>,
    pub metadata: Option<serde_json::Value>,
}

/// Response returned after successfully creating a payment.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct PaymentResponse {
    pub transaction_id: String,
    pub amount: u64,
    pub payment_instrument: PaymentInstrument,
    pub status: PaymentStatus,
    pub redirect_url: Option<String>,
}

/// Request payload to initiate a refund.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct RefundRequest {
    pub transaction_id: String,
    pub amount: u64,
    pub reason: Option<String>,
}

/// Response returned after processing a refund.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct RefundResponse {
    pub refund_id: String,
    pub status: PaymentStatus,
    pub transaction_id: String,
    pub refunded: bool,
}