Hızlı Başlangıç
HsrcPay SDK ile ilk ödeme akışını kısa sürede ayağa kaldırın.
Bu rehber, test ortamında çalışan bir entegrasyonu hızlıca kurman için optimize edilmiştir.
1) SDK Kurulumu
npm install @hsrcpay/sdk2) Client oluşturma
import { HsrcPay } from "@hsrcpay/sdk";
export const hsrcpay = new HsrcPay({
apiKey: process.env.HSRCPAY_API_KEY!,
environment: "sandbox",
});3) Ödeme oluşturma
const payment = await hsrcpay.payments.create({
amount: 12500,
currency: "TRY",
customer: {
email: "customer@example.com",
name: "Demo Kullanici",
},
metadata: {
orderId: "ORD-2026-0001",
},
});4) Durum sorgulama
const latest = await hsrcpay.payments.get(payment.id);
console.log(latest.status);Önemli
sandbox ve production anahtarlarını kesinlikle aynı ortamda kullanma. CI/CD ve deployment sırasında ortam değişkenlerini birbirinden ayır.
Sonraki adımlar
- Checkout tabanlı akış için
checkout-sessions - Olay tabanlı senkronizasyon için
webhooks - Canlı geçiş öncesi kalite güvencesi için
pre-production-checklist