Hızlı Başlangıç
HsrcPay SDK ile ilk ödeme akışını kısa sürede ayağa kaldırın.
On beş dakikada sandbox’ta uçtan uca denemeniz için kısaltılmış akış. REST detayı için API Reference ve kavramlar için Dökümantasyon yeterli olur.
1) Kurulum
npm install @hsrcpay/sdk2) Client
import { HsrcPay } from "@hsrcpay/sdk";
export const hsrcpay = new HsrcPay({
apiKey: process.env.HSRCPAY_API_KEY!,
environment: "sandbox",
});3) Payment + confirm
const payment = await hsrcpay.payments.create({
amount: 12500,
currency: "TRY",
metadata: { orderId: "ORD-2026-0001" },
});
const confirmed = await hsrcpay.payments.confirm(payment.id, {
paymentMethod: { id: process.env.SANDBOX_PM_ID! },
payerIdentity: { ipAddress: "203.0.113.1", userAgent: "demo/1.0" },
});
console.log(confirmed.payment.status);4) Doğrulama
const latest = await hsrcpay.payments.get(payment.id);Webhook kurulumu için Webhooks; canlı öncesi Pre-Production Checklist.
Ortam ayrımı
Sandbox ve production anahtarlarını aynı deployment’ta karıştırmayın.