okulcom-api — Payment Modeli (B2B Abonelik Ödemeleri)

Proje: Okul Platform · Hub: Okul Platform — Domain

Payment vs CreditCardPayment Farkı

	Payment	CreditCardPayment
Kullanım	B2B abonelik ödemeleri	Veli kredi kartı ödemeleri
Bağlantı	CustomerAgreement	School + Product
Provider	iyzico / paramPos	Farklı

Payment Model (B2B)

Ödeme Sağlayıcıları

const PAYMENT_PROVIDER_IYZICO = 'iyzico';
const PAYMENT_PROVIDER_PARAM_POS = 'paramPos';

Önemli Alanlar

• customer_id → Customer
• customer_agreement_id → CustomerAgreement
• status_id → PaymentStatus (pending/success/failed/future/cancelled/refund…)
• amount, tax_rate — Tutar ve vergi
• installment — Taksit sayısı
• payment_date, payment_due_date — Gerçek ve vadeli ödeme tarihi
• recurring_month — Tekrar eden ay sayısı
• last_recurring_at — Son tekrar tarihi
• inflation_rate_id → InflationRate (enflasyon güncellemesi için)
• product_price_id → ProductPrice
• payment_type_id → PaymentType (cash/money_order/mail_order/credit_card/barter/cheque)
• payment_provider — Provider adı
• reference_number, return_code, return_message — İşlem detayları
• erp_code — ERP referans kodu
• currency_code — Para birimi

CustomerIO Entegrasyonu

CustomerIO\DTO\Payment — Payment modelinden CIO’ya gönderilen veri:

• type (payment_type_id)
• status
• amount
• installment
• paymentDueDate
• paymentDate

Event: PaymentStatusUpdated — Ödeme durumu değişince CIO B2B event tetikler.

Related

• api-payment-system — Ödeme genel sistemi
• api-customer-agreement — Sözleşme ödemeleri
• api-customerio-events — PaymentStatusUpdated CIO event