Kurulum
SDK paket kurulumu, gereksinimler ve proje entegrasyon adımları.
Gereksinimler
- Node.js 18+ veya Bun runtime
- HsrcPay Dashboard üzerinden üretilmiş API anahtarı
- Güvenli ortam değişkeni yönetimi (
.env, secret manager, CI variables)
Paket kurulumu
npm install @hsrcpay/sdkOrtam değişkeni
HSRCPAY_API_KEY=sk_test_xxxxxxxxx
HSRCPAY_ENVIRONMENT=sandboxTemel istemci örneği
import { HsrcPay } from "@hsrcpay/sdk";
export const hsrcpay = new HsrcPay({
apiKey: process.env.HSRCPAY_API_KEY!,
environment: process.env.HSRCPAY_ENVIRONMENT === "production" ? "production" : "sandbox",
timeoutMs: 10_000,
});Sağlık kontrolü
İlk entegrasyonda düşük riskli bir list veya get çağrısı ile bağlantıyı doğrula:
const providers = await hsrcpay.paymentProviders.list({ limit: 5 });
console.log("provider count", providers.data.length);Pre-prod önerisi
Kurulum adımını deployment pipeline'ında ayrı bir smoke-check job'ı ile doğrulamak, canlı release riskini ciddi biçimde düşürür.