Data Models - Payments & Charges
Ödeme servisinde payment, charge, refund ve checkout session kaynaklarının model özeti.
Bu bölüm, entegrasyon sırasında hangi kaynağın hangi sorumluluğu taşıdığını hızlıca görmen için hazırlanmıştır.
payments modeli
Öne çıkan alanlar:
- Kimlik/sahiplik:
id,account_id,customer_id,checkout_session_id - İşlem verisi:
amount,currency,installments,status - İş kuralı alanları:
auto_capture,secure_mode,routing_origin - Context snapshot:
billing_details,shipping_details,payer_identity,next_action - İlişkiler:
charges[],routing_plans[]
charges modeli
charges, fiili tahsilat denemesini temsil eder.
- Bağlantılar:
payment_id,payment_method_id,payment_provider_method_id - Sağlayıcı bağlamı:
payment_provider_id,payment_provider_config_id,payment_provider_config_snapshot - Durum/tutar:
status,amount,authorized_amount,captured_amount,refunded_amount - Routing:
routing_plan_id,attempt_no,routing_origin - İlişki:
refunds[]
refunds modeli
- Temel alanlar:
charge_id,status,reason,amount,currency - Hata alanları:
error,error_message - Status seti:
CREATED,PROCESSING,COMPLETED,FAILED
checkout_sessions modeli
Checkout session, payment link snapshot veya manuel oluşturulmuş ödeme oturumudur.
- Kimlik/sahiplik:
id,account_id,payment_link_id,customer_id,payment_id - Public erişim:
token - Tutar modu:
amount_mode,fixed_amount,customer_entered_amount,final_amount - Kullanıcı verisi:
payer_name,payer_email,payer_phone, adres snapshot alanları - Kurallar:
status,expires_at,completed_at,cancelled_at - İlişki:
line_items[]
Modelleme notları
paymentsvechargesayrımı, orchestration/routing denemelerini görünür kılar.checkout_sessions.payment_link_idvepayment_idsoft reference yaklaşımıyla tutulur.- Merchant metadata (
metadata) ile sistem metadata/data (data) ayrımı çoğu modelde korunur.