Struct GiftCards 

pub struct GiftCards { /* private fields */ }

Gift card operations for issuing, charging, and refunding.

Implementations

impl GiftCards

pub fn is_supported(&self) -> bool

Whether gift cards are supported by the active backend.

pub fn create(&self, input: CreateGiftCard) -> Result<GiftCard>

Create a new gift card.

Example

use stateset_embedded::{Commerce, CreateGiftCard, CustomerId};
use rust_decimal_macros::dec;

let commerce = Commerce::new("./store.db")?;

let gift_card = commerce.gift_cards().create(CreateGiftCard {
    initial_balance: dec!(100.00),
    customer_id: Some(CustomerId::new()),
    ..Default::default()
})?;

pub fn get(&self, id: GiftCardId) -> Result<Option<GiftCard>>

Get a gift card by ID.

pub fn get_by_code(&self, code: &str) -> Result<Option<GiftCard>>

Get a gift card by its unique code.

pub fn update(&self, id: GiftCardId, input: UpdateGiftCard) -> Result<GiftCard>

Update a gift card.

pub fn list(&self, filter: GiftCardFilter) -> Result<Vec<GiftCard>>

List gift cards with optional filtering.

pub fn charge( &self, id: GiftCardId, amount: Decimal, reference_id: Option<String>, ) -> Result<GiftCardTransaction>

Charge (debit) a gift card.

Reduces the gift card balance by the specified amount.

pub fn refund( &self, id: GiftCardId, amount: Decimal, reference_id: Option<String>, ) -> Result<GiftCardTransaction>

Refund (credit) to a gift card.

Increases the gift card balance by the specified amount.

pub fn disable(&self, id: GiftCardId) -> Result<GiftCard>

Disable a gift card so it can no longer be used.

pub fn get_transactions( &self, gift_card_id: GiftCardId, ) -> Result<Vec<GiftCardTransaction>>

Get transaction history for a gift card.

Trait Implementations

impl Debug for GiftCards

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.