HSRCPAY Dökümantasyon

Checkout Sessions

Hosted checkout oturumları ile düşük eforlu ödeme entegrasyonu.

Checkout session, ödeme sayfasını hızlıca canlıya alman için önerilen başlangıç yöntemidir.

Session oluşturma

const session = await hsrcpay.checkoutSessions.create({
  amount: 25900,
  currency: "TRY",
  customer: {
    email: "omer@example.com",
  },
  successUrl: "https://merchant.example.com/checkout/success",
  cancelUrl: "https://merchant.example.com/checkout/cancel",
});

Kullanıcı yönlendirme

return Response.redirect(session.url, 303);

Session doğrulama

Kullanıcı başarı sayfasına döndüğünde:

  1. Session veya payment kimliğini backend'de tekrar sorgula.
  2. Siparişi yalnızca doğrulanmış başarılı durumda kapat.
  3. Webhook ile nihai mutabakat yap.

Güvenlik notu

successUrl üzerinde gelen parametreleri tek başına kanıt kabul etme; her zaman sunucu tarafı API kontrolü uygula.

On this page