Checkout Sessions

Checkout session, ödeme sayfasını hızlıca açmak isteyen ekipler için iyi bir başlangıçtır. Confirm ve 3DS adımlarının bir kısmı checkout deneyiminde kalabilir; yine de siparişi kapatırken webhook veya sunucu tarafı payment sorgusu şarttır.

Detay: Checkout Session Rehberi.

Session oluşturma

const session = await hsrcpay.checkoutSessions.create({
  amount: 25900,
  currency: "TRY",
  url: "https://pay.merchant.example/checkout",
  returnUrl: "https://merchant.example.com/return",
  metadata: { orderId: "ORD-42" },
});

url hosted ödeme sayfanızdır; API token üretir ve payer bu oturuma bağlanır.

Yönlendirme

return Response.redirect(
  `${session.url}?token=${session.token}`,
  303,
);

Doğrulama

Kullanıcı returnUrl ile döndüğünde:

1. Session veya bağlı payment’ı API ile tekrar okuyun.
2. Siparişi yalnızca SUCCEEDED / AUTHORIZED (iş kuralınıza göre) sonrası kapatın.
3. Webhook ile mutabakat yapın.

Return URL kullanıcı deneyimini bitirir; finansal kanıt değildir.