Struct Payment 

pub struct Payment {

    pub id: Uuid,
    pub organization_id: Uuid,
    pub building_id: Uuid,
    pub owner_id: Uuid,
    pub expense_id: Option<Uuid>,
    pub amount_cents: i64,
    pub currency: String,
    pub status: TransactionStatus,
    pub payment_method_type: PaymentMethodType,
    pub stripe_payment_intent_id: Option<String>,
    pub stripe_customer_id: Option<String>,
    pub payment_method_id: Option<Uuid>,
    pub idempotency_key: String,
    pub description: Option<String>,
    pub metadata: Option<String>,
    pub failure_reason: Option<String>,
    pub refunded_amount_cents: i64,
    pub succeeded_at: Option<DateTime<Utc>>,
    pub failed_at: Option<DateTime<Utc>>,
    pub cancelled_at: Option<DateTime<Utc>>,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
}

Payment entity - Represents a payment for an expense

Belgian property management context:

• Payments are always in EUR (Belgian currency)
• Linked to Expense entity (charge to co-owners)
• Supports Stripe (cards) and SEPA (bank transfers)
• Includes idempotency key for safe retries

Fields

id: Uuid

organization_id: Uuid

Organization (multi-tenant isolation)

building_id: Uuid

Building this payment relates to

owner_id: Uuid

Owner making the payment

expense_id: Option<Uuid>

Expense being paid (optional: could be general account credit)

amount_cents: i64

Payment amount in cents (EUR) - Stripe uses smallest currency unit

currency: String

Currency (always EUR for Belgian context)

status: TransactionStatus

Payment transaction status

payment_method_type: PaymentMethodType

Payment method type used

stripe_payment_intent_id: Option<String>

Stripe payment intent ID (for card/SEPA payments)

stripe_customer_id: Option<String>

Stripe customer ID (for recurring customers)

payment_method_id: Option<Uuid>

Stored payment method ID (if saved for future use)

idempotency_key: String

Idempotency key for safe retries (prevents duplicate charges)

description: Option<String>

Optional description

metadata: Option<String>

Optional metadata (JSON) for extensibility

failure_reason: Option<String>

Failure reason (if status = Failed)

refunded_amount_cents: i64

Refund amount in cents (if status = Refunded)

succeeded_at: Option<DateTime<Utc>>

Date when payment succeeded (if status = Succeeded)

failed_at: Option<DateTime<Utc>>

Date when payment failed (if status = Failed)

cancelled_at: Option<DateTime<Utc>>

Date when payment was cancelled (if status = Cancelled)

created_at: DateTime<Utc>

updated_at: DateTime<Utc>

Implementations

impl Payment

pub fn new( organization_id: Uuid, building_id: Uuid, owner_id: Uuid, expense_id: Option<Uuid>, amount_cents: i64, payment_method_type: PaymentMethodType, idempotency_key: String, description: Option<String>, ) -> Result<Self, String>

Create a new payment intent

Arguments

• organization_id - Organization ID (multi-tenant)
• building_id - Building ID
• owner_id - Owner making the payment
• expense_id - Optional expense being paid
• amount_cents - Amount in cents (EUR)
• payment_method_type - Payment method type
• idempotency_key - Idempotency key for safe retries
• description - Optional description

Returns

• Ok(Payment) - New payment with status Pending
• Err(String) - Validation error

pub fn mark_processing(&mut self) -> Result<(), String>

Mark payment as processing

pub fn mark_requires_action(&mut self) -> Result<(), String>

Mark payment as requiring action (e.g., 3D Secure authentication)

pub fn mark_succeeded(&mut self) -> Result<(), String>

Mark payment as succeeded

pub fn mark_failed(&mut self, reason: String) -> Result<(), String>

Mark payment as failed

pub fn mark_cancelled(&mut self) -> Result<(), String>

Mark payment as cancelled

pub fn refund(&mut self, refund_amount_cents: i64) -> Result<(), String>

Refund payment (partial or full)

pub fn set_stripe_payment_intent_id(&mut self, payment_intent_id: String)

Set Stripe payment intent ID

pub fn set_stripe_customer_id(&mut self, customer_id: String)

Set Stripe customer ID

pub fn set_payment_method_id(&mut self, payment_method_id: Uuid)

Set payment method ID (for saved payment methods)

pub fn set_metadata(&mut self, metadata: String)

Set metadata

pub fn get_net_amount_cents(&self) -> i64

Get net amount after refunds (in cents)

pub fn is_final(&self) -> bool

Check if payment is in final state (cannot be modified)

pub fn can_refund(&self) -> bool

Check if payment can be refunded

Trait Implementations

impl Clone for Payment

fn clone(&self) -> Payment

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Payment

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Payment

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<Payment> for PaymentResponse

fn from(payment: Payment) -> Self

Converts to this type from the input type.

impl Serialize for Payment

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.