Payments Akışı

Temel ödeme oluşturma

const payment = await hsrcpay.payments.create({
  amount: 15900,
  currency: "TRY",
  customer: {
    email: "ayse@example.com",
  },
  metadata: {
    cartId: "CART-1042",
  },
});

Ödeme durumları

Tipik yaşam döngüsü:

• requires_payment_method
• requires_action (3DS vb.)
• processing
• succeeded
• expired

Durum güncelleme yaklaşımı

1. Kullanıcıyı senkron response ile bilgilendir.
2. Nihai doğrulama için webhook event'ini kaynak olarak kabul et.
3. Sipariş kapanışını yalnızca başarılı event alındığında tamamla.

Önerilen domain modeli

type OrderPaymentState = "pending" | "authorized" | "paid" | "requires_payment_method" | "refunded";

Uygulama tarafında kendi ödeme durum haritanı API durumlarından türet; doğrudan 1

Hata durumları

• 4xx: istek doğrulama veya yetki problemi
• 409: idempotency/replay çakışmaları
• 5xx: geçici servis problemi, kontrollü retry gerekir